Merge pull request #5 from opensourceops/codex/v0.3.0-docs

Publish agentctl 0.3.0 workflow API v1 documentation

Author: Ompragash

.github/workflows/pages.yml

@@ -15,7 +15,7 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  AGENTCTL_COMMIT: "736379ed5f49b0dbe1ad79ac4e4ba794e2c73c47"
+  AGENTCTL_COMMIT: "2aeaa88fba71162206b5f08f5bda4f0150247e4f"
   NODE_VERSION: "24.4.1"
   PNPM_VERSION: "11.9.0"
   RUST_TOOLCHAIN: "1.88.0"

astro.config.mjs

@@ -56,7 +56,7 @@ export default defineConfig({
         {
           label: 'Start here',
           items: [
-            { slug: 'overview', label: 'Overview', badge: 'v1alpha1' },
+            { slug: 'overview', label: 'Overview', badge: 'v1' },
             { slug: 'why-agentctl', label: 'Why agentctl' },
             { slug: 'concepts/product', label: 'Product definition' },
             { slug: 'concepts/framework-completeness', label: 'Framework completeness' },

docs/execution/AGENTCTL_DOCS_DECISIONS.md

@@ -28,7 +28,12 @@ A checked manifest maps canonical source files to public routes. The importer fa
 
 Status: accepted, 2026-07-23.
 
-Public pages distinguish deterministic tests, mock-protocol tests, retained live OpenAI evidence, locally executed container evidence, hosted CI configuration, hosted CI execution, syntax validation, deferred work, and unsupported work. The site calls the project a `v1alpha1` release candidate preparation, not stable or production proven.
+Public pages distinguish deterministic tests, mock-protocol tests, retained
+live OpenAI evidence, locally executed container evidence, hosted CI execution,
+syntax validation, deferred work, and unsupported work. The site identifies
+`agentctl.dev/v1` as the stable workflow document API while keeping the 0.3 CLI
+and crates explicitly pre-1.0 and avoiding unsupported production or provider
+claims.
 
 ## D006: Static and restrained design
 

docs/execution/AGENTCTL_DOCS_INFORMATION_ARCHITECTURE.md

@@ -16,7 +16,7 @@
 - Architecture
 - Contributing
 - GitHub
-- `v1alpha1` maturity indicator
+- workflow API `v1` indicator
 
 ## Learning paths
 

public/meta/agentctl-source.json

@@ -1,8 +1,8 @@
 {
   "product": "agentctl",
-  "version": "0.2.0",
-  "workflowApi": "agentctl.dev/v1alpha1",
-  "commit": "736379ed5f49b0dbe1ad79ac4e4ba794e2c73c47",
+  "version": "0.3.0",
+  "workflowApi": "agentctl.dev/v1",
+  "commit": "2aeaa88fba71162206b5f08f5bda4f0150247e4f",
   "dirty": false,
   "sourceRepository": "https://github.com/opensourceops/agentctl",
   "importedFiles": 61

scripts/content-manifest.mjs

@@ -6,7 +6,7 @@ export const contentManifest = [
   ['docs/TOOLS.md', '_generated/concepts/tools.md', 'Tools and effects', 'Tool contracts, effect classes, idempotency, and deterministic checks.'],
   ['docs/memory.md', '_generated/concepts/memory.md', 'State and memory', 'Separate runtime state, working memory, long-term memory, and prompt cache.'],
   ['docs/PACKS.md', '_generated/concepts/packs.md', 'Reusable packs', 'Use versioned local content with integrity verification.'],
-  ['docs/guides/INSTALLATION.md', '_generated/getting-started/installation.md', 'Installation', 'Build or install the current v1alpha1 candidate from reviewed source.'],
+  ['docs/guides/INSTALLATION.md', '_generated/getting-started/installation.md', 'Installation', 'Build or install agentctl 0.3 with workflow API v1 from reviewed source.'],
   ['docs/guides/GETTING_STARTED.md', '_generated/getting-started/index.md', 'Getting started', 'Run and inspect a credential-free deterministic workflow.'],
   ['docs/guides/FIRST_AGENT_WORKFLOW.md', '_generated/getting-started/first-agent.md', 'First agent workflow', 'Run a bounded tool-using agent without a paid API key.'],
   ['docs/guides/WORKFLOW_AUTHORING.md', '_generated/guides/workflow-authoring.md', 'Author workflows', 'Learn workflow YAML in execution order.'],
@@ -42,7 +42,7 @@ export const contentManifest = [
   ['docs/execution/COMPLETENESS_VERIFICATION.md', '_generated/reference/completeness-verification.md', 'Completeness verification', 'Deterministic, container, security, and independent review evidence.'],
   ['docs/execution/LIVE_FRAMEWORK_VERIFICATION.md', '_generated/reference/live-framework-verification.md', 'Live framework verification', 'Sanitized GPT-5.6 scenario, recovery, replay, usage, and container evidence.'],
   ['docs/COMPATIBILITY.md', '_generated/reference/compatibility.md', 'Compatibility', 'Preserved, migrated, changed, removed, and explicit non-goal contracts.'],
-  ['docs/MIGRATING_FROM_TYPESCRIPT.md', '_generated/reference/migration.md', 'Migrate from TypeScript', 'Translate supported legacy workflows to strict v1alpha1 YAML.'],
+  ['docs/MIGRATING_FROM_TYPESCRIPT.md', '_generated/reference/migration.md', 'Migrate from TypeScript', 'Translate supported legacy workflows to strict workflow API v1 YAML.'],
   ['docs/ARCHITECTURE.md', '_generated/architecture/index.md', 'Architecture overview', 'Crate boundaries, execution, determinism, concurrency, and packaging.'],
   ['docs/architecture/DIAGRAMS.md', '_generated/architecture/diagrams.md', 'Architecture diagrams', 'Fourteen verified diagrams for compilation, state, effects, recovery, deployment, and crates.'],
   ['docs/adr/0001-deterministic-core-explicit-effects.md', '_generated/architecture/decisions/0001.md', 'ADR 0001: Deterministic core', 'Keep graph, policy, state, and replay model-independent.'],
@@ -59,5 +59,5 @@ export const contentManifest = [
   ['docs/development/ADD_MIGRATION.md', '_generated/contributing/add-migration.md', 'Add a store migration', 'Version and test forward SQLite migrations.'],
   ['docs/development/DOCUMENTATION.md', '_generated/contributing/documentation.md', 'Write documentation', 'Own content in the right repository and verify it end to end.'],
   ['docs/TESTING.md', '_generated/contributing/testing.md', 'Testing strategy', 'Credential-free gates, acceptance layers, fuzzing, and live evidence.'],
-  ['docs/RELEASE_PROCESS.md', '_generated/contributing/release.md', 'Release process', 'Prepare and verify a v1alpha1 release candidate without overstating evidence.']
+  ['docs/RELEASE_PROCESS.md', '_generated/contributing/release.md', 'Release process', 'Prepare and verify an exact-commit release without overstating evidence.']
 ];

scripts/sync-agentctl.mjs

@@ -221,7 +221,7 @@ await copyFile(
 const metadata = {
   product: 'agentctl',
   version,
-  workflowApi: 'agentctl.dev/v1alpha1',
+  workflowApi: 'agentctl.dev/v1',
   commit,
   dirty,
   sourceRepository: 'https://github.com/opensourceops/agentctl',

src/components/Header.astro

@@ -14,7 +14,7 @@ const base = import.meta.env.BASE_URL;
 <div class="site-header">
   <div class="title-wrapper sl-flex">
     <SiteTitle />
-    <span class="maturity" aria-label="Workflow API maturity: version 1 alpha 1">v1alpha1</span>
+    <span class="maturity" aria-label="Workflow API version 1">v1</span>
   </div>
   <nav class="top-links" aria-label="Primary">
     <a href={`${base}overview/`}>Docs</a>

src/components/Homepage.astro

@@ -166,15 +166,15 @@ const shortCommit = source.commit.slice(0, 8);
       <p class="eyebrow">Current maturity</p>
       <h2 id="maturity-title">Exact-commit evidence across local and hosted gates</h2>
       <p>
-        The workflow API is <code>agentctl.dev/v1alpha1</code>. Deterministic composition, durable recovery,
+        The workflow API is <code>agentctl.dev/v1</code>. Deterministic composition, durable recovery,
         local persistence, native Linux arm64 containers, and bounded GPT-5.6 journeys have executable evidence.
-        The pinned candidate also passed hosted Linux x64, macOS arm64, Windows x64, container, security,
+        The pinned 0.3 release source also passed hosted Linux x64, macOS arm64, Windows x64, container, security,
         package, SBOM, and release-preparation gates. Other native providers and protocols have mock coverage
         at documented levels.
       </p>
     </div>
     <ul>
-      <li>No stable v1 compatibility promise</li>
+      <li>Stable workflow API v1; CLI and crates remain pre-1.0</li>
       <li>No exactly-once or in-process sandbox claim</li>
       <li>No distributed or cross-run scheduler claim</li>
       <li>No claim of live validation across every provider</li>

src/content/docs/_generated/architecture/decisions/0001.md

@@ -8,4 +8,4 @@ Status: accepted, 2026-07-22.
 The graph, policy, state machine, persistence decisions, and recorded replay remain model-independent. Provider, tool, filesystem, process, MCP, A2A, internal-state mutation, clock, and ID behavior cross injected interfaces and receive durable effect identity when externally observable.
 
 This keeps models replaceable and tests credential-free. It requires more records and conservative uncertain states, but avoids hidden calls during replay. Dynamic model-owned orchestration is rejected.
-> Canonical source: [`docs/adr/0001-deterministic-core-explicit-effects.md`](https://github.com/opensourceops/agentctl/blob/main/docs/adr/0001-deterministic-core-explicit-effects.md). Verified against agentctl commit `736379ed5f49b0dbe1ad79ac4e4ba794e2c73c47`.
+> Canonical source: [`docs/adr/0001-deterministic-core-explicit-effects.md`](https://github.com/opensourceops/agentctl/blob/main/docs/adr/0001-deterministic-core-explicit-effects.md). Verified against agentctl commit `2aeaa88fba71162206b5f08f5bda4f0150247e4f`.