agentic-workspace 1.0.0rc3__tar.gz

agentic_workspace-1.0.0rc3/.agentic-workspace/instructions/workspace-operating.md

@@ -0,0 +1,42 @@
+---
+paths:
+  - .agentic-workspace/**
+  - src/agentic_workspace/**
+  - packages/**
+  - scripts/**
+  - tests/**
+  - docs/**
+  - crates/**
+  - .github/**
+read:
+  - docs/maintainer/testing-strategy.md
+protect:
+  - .agentic-workspace/local/decision-point-intent/73a213e66cd48a33.json
+---
+
+# Workspace operating guidance
+
+Start from the compact Agentic Workspace route before opening raw planning,
+memory, verification, or configuration state. Use exact selectors and routed
+owners before broad reads. Keep package boundaries explicit and do not treat a
+successful focused action as proof of a broader completion claim.
+
+Preserve the unresolved Planning decision-point source named above. Its bytes do
+not yet have independently established source-owner custody/admission (#2970).
+Do not infer ownership from its path, schema or inline owner strings. Remove or
+revise this restriction only when that source-authority gate is actually resolved
+and the repository owner admits the revised instruction. This rule supplies no
+mutation, custody, or proof-success authority.
+
+For changes to behavior, executable tests or ordinary CI, apply the testing strategy before
+adding permanent evidence or choosing validation. Use its contract ladder,
+add/merge/convert/prune rules, and test/CI delta disposition at closeout. This
+includes tests embedded in Rust and package code. A material duplicate, temporary
+batch taxonomy, or unjustified recurring cost must be resolved before presenting
+the work for approval. Existing workspace-proof-selection and Verification remain
+the proof owners; this instruction is repository review discipline, not a new
+selector. Distinguish evidence design, current patch validation and permanent retention as
+that strategy defines them. A fix or incident reproduction does not by itself
+justify another permanent regression; inspect existing stable owner evidence
+first. Closeout states why proof can stop or which named material risk requires
+bounded escalation. Run broader proof only for that stated current claim.

agentic_workspace-1.0.0rc3/.agentic-workspace/instructions/workspace-ownership-audit.md

@@ -0,0 +1,10 @@
+---
+routes:
+  - workspace/ownership/audit
+use:
+  - ownership-ledger-check
+---
+
+# Workspace ownership audit
+
+Use the registered ownership-ledger procedure when the acting agent selects this semantic route. The route is applicability evidence only and does not change repository policy or mutation authority.

agentic_workspace-1.0.0rc3/.agentic-workspace/memory/repo/decisions/installed-system-consolidation-2026-04-05.md

@@ -0,0 +1,54 @@
+# Decision: Root-Owned Installed Systems
+
+## Status
+
+Accepted
+
+## Date
+
+2026-04-05
+
+## Load when
+
+- Deciding operational ownership between root and package-local systems.
+- Reviewing root-orchestration changes that affect planning or memory routing.
+
+## Review when
+
+- Root orchestration, CI validation, or package cleanup strategy changes.
+
+## Failure signals
+
+- Duplicate installed systems become operational authorities again in package roots.
+- Root and package workflows diverge on where planning or memory ownership lives.
+
+## Decision
+
+Use a single package-owned installed memory system and a module-managed planning system for the monorepo, with the package-managed home under `.agentic-workspace/`, then remove duplicate package-local installed systems from packages/memory and packages/planning.
+
+## Why
+
+- Duplicate installed systems create conflicting ownership for routing, workflow entrypoints, and current-state notes.
+- uv workspace resolution remains workspace-wide from member directories, so cwd alone does not provide robust system isolation.
+- Root orchestration and CI are easier to reason about when operational systems are owned once in the package-managed install home and projected into the repo-facing contract only when needed.
+
+## Consequences
+
+- Package knowledge and planning context must be intentionally preserved in root-owned notes before package-local operational copies are removed.
+- Package-level validation still runs through package-scoped sync/check lanes.
+- Package-local installed-system files are no longer authoritative for monorepo operations, and planning state now lives in `.agentic-workspace/planning/state.toml` as module-managed state.
+
+## Follow-through
+
+- Keep package context summaries in .agentic-workspace/memory/repo/domains/memory-package-context.md and .agentic-workspace/memory/repo/domains/planning-package-context.md.
+- Use uninstall commands in package roots to clean package-local installed-system surfaces.
+
+## Verify
+
+- .agentic-workspace/planning/state.toml
+- Makefile
+- .github/workflows/ci.yml
+
+## Last confirmed
+
+2026-04-05 during root consolidation and package cleanup

agentic_workspace-1.0.0rc3/.agentic-workspace/memory/repo/manifest.toml

@@ -0,0 +1,68 @@
+version = 1
+
+[rules]
+canonical_dirs = [
+  ".agentic-workspace/memory/repo/domains",
+  ".agentic-workspace/memory/repo/invariants",
+  ".agentic-workspace/memory/repo/runbooks",
+  ".agentic-workspace/memory/repo/mistakes",
+  ".agentic-workspace/memory/repo/decisions",
+]
+task_board_globs = ["TODO.md", "tasks/**", ".github/issues/**"]
+
+[notes.".agentic-workspace/memory/repo/index.md"]
+note_type = "routing"
+canonical_home = ".agentic-workspace/memory/repo/index.md"
+task_relevance = "optional"
+routes_from = ["AGENTS.md", ".agentic-workspace/memory/repo/**/*.md"]
+stale_when = [".agentic-workspace/memory/repo/manifest.toml", ".agentic-workspace/memory/repo/**/*.md"]
+
+[notes.".agentic-workspace/memory/repo/domains/example-runtime-boundary.md"]
+note_type = "domain"
+canonical_home = ".agentic-workspace/memory/repo/domains/example-runtime-boundary.md"
+task_relevance = "optional"
+routes_from = ["src/agentic_workspace/**", "generated/**", "scripts/generate/**"]
+stale_when = ["src/agentic_workspace/contracts/**", "scripts/generate/**", "generated/**"]
+
+[notes.".agentic-workspace/memory/repo/domains/memory-package-context.md"]
+note_type = "domain"
+canonical_home = ".agentic-workspace/memory/repo/domains/memory-package-context.md"
+task_relevance = "optional"
+routes_from = ["packages/memory/**"]
+stale_when = ["packages/memory/src/**", "packages/memory/bootstrap/**", "packages/memory/README.md"]
+
+[notes.".agentic-workspace/memory/repo/domains/planning-package-context.md"]
+note_type = "domain"
+canonical_home = ".agentic-workspace/memory/repo/domains/planning-package-context.md"
+task_relevance = "optional"
+routes_from = ["packages/planning/**", ".agentic-workspace/planning/**"]
+stale_when = ["packages/planning/src/**", "packages/planning/bootstrap/**", "packages/planning/README.md"]
+
+[notes.".agentic-workspace/memory/repo/decisions/installed-system-consolidation-2026-04-05.md"]
+note_type = "decision"
+canonical_home = ".agentic-workspace/memory/repo/decisions/installed-system-consolidation-2026-04-05.md"
+task_relevance = "optional"
+routes_from = [".agentic-workspace/**", "packages/memory/**", "packages/planning/**"]
+stale_when = [".agentic-workspace/config.toml", "src/agentic_workspace/contracts/module_registry.json", "packages/*/pyproject.toml"]
+disposition = { note_revision = "sha256:06332182cc9f0085b4c0d6d2bdf132ff607c8eb339b1c403f3700ac9031100fa", reason = "The human determined that this note is no longer necessary as a memory note. Retire it from active Memory selection; preserve the source text without promoting or confirming its historical claims.", status = "retire" }
+
+[notes.".agentic-workspace/memory/repo/mistakes/recurring-failures.md"]
+note_type = "recurring-failures"
+canonical_home = ".agentic-workspace/memory/repo/mistakes/recurring-failures.md"
+task_relevance = "optional"
+semantic_routes = ["github/pr/review"]
+routes_from = ["src/agentic_workspace/workspace_runtime_*.py", ".agentic-workspace/planning/**"]
+stale_when = ["src/agentic_workspace/workspace_runtime_planning.py", "src/agentic_workspace/workspace_runtime_startup.py"]
+
+[durable_facts."selected-plan-owned-next-task"]
+summary = "When current work belongs to the selected Planning owner, rebind from that owner and task; preserve older closeout residue separately instead of classifying the owned task as unrelated."
+owner = "planning-route-decision"
+evidence = [".agentic-workspace/memory/repo/mistakes/recurring-failures.md", "src/agentic_workspace/workspace_runtime_planning.py"]
+authority_class = "advisory"
+note_ref = ".agentic-workspace/memory/repo/mistakes/recurring-failures.md#failure-selected-plan-blocks-its-next-owned-task"
+promotion = "Promote when the route classifier can mechanically preserve the owner/task relation."
+demotion_or_expiry = "Retire after the stronger Planning owner prevents the recurrence and regression proof remains stable. After admitted promotion, retain only a stub."
+promotion_target = "planning-route-decision / issue #2566 or successor"
+promotion_trigger = "The same owner/task relation is classified independent-pending-scope after this fact was projected."
+preferred_remediation = "Make the structured Planning route classifier preserve selected-owner task relations."
+elimination_target = "selected plan blocks its next owned task"

agentic_workspace-1.0.0rc3/.agentic-workspace/planning/execplans/delegation-lane-sweep.plan.json

@@ -0,0 +1,126 @@
+{
+  "kind": "planning-execplan/v1",
+  "id": "delegation-lane-sweep",
+  "title": "Reconstruct delegation execution configurations, transport continuity and attributed completion evidence",
+  "owner_level": "slice",
+  "lifecycle": "live",
+  "phase": "implementation",
+  "revision": 4,
+  "intent": {
+    "outcome": "Exhaust coherent delegation lane through proved stacked PRs from reconstruct/foundation-contract: execution configurations, native continuity, bounded context, attributed lifecycle burden and conformance.",
+    "non_goals": [
+      "No merge, master modification, provider transcript store, session manager, global ranking or self-approval."
+    ]
+  },
+  "parent": {
+    "owner_id": "none",
+    "contribution": "Exhaust coherent delegation lane through proved stacked PRs from reconstruct/foundation-contract: execution configurations, native continuity, bounded context, attributed lifecycle burden and conformance.",
+    "closure_boundary": "this slice only"
+  },
+  "scope": {
+    "owned": [
+      "crates/agentic-workspace-core",
+      "src/agentic_workspace",
+      "tests",
+      "packages/planning",
+      "packages/verification",
+      "generated",
+      "scripts",
+      "docs",
+      ".agentic-workspace/planning/execplans/delegation-lane-sweep.plan.json"
+    ],
+    "effects": [
+      "Bounded repository edits, generated projections, executable proof and stacked pull requests; no merge or independent review approval."
+    ]
+  },
+  "relationships": {
+    "selection": {
+      "state": "selected-local",
+      "owner": "delegation-lane-sweep"
+    },
+    "proof_posture": {
+      "state": "pending",
+      "refs": []
+    },
+    "external_posture": {
+      "state": "unobserved",
+      "refs": []
+    },
+    "delegation": {
+      "state": "recorded",
+      "route": "keep-local",
+      "reason": "Current orchestrator retains parent custody. Configured native peers are available through revision-bound assignments; two bounded supported-host inspection attempts returned no verdict. Further inference requires a concrete evidence purpose and explicit bounded cost, not speculative diagnosis. Independent PR review remains pending.",
+      "scope": "active-plan-work-unit",
+      "parent_task_custody": "retained-current",
+      "bounded_child_authority": "separate-binding-decision"
+    }
+  },
+  "references": [],
+  "next_action": "Bind delegation to the Planning owner projection and current selected-owner content, prove the layer, then reassess unresolved issue outcomes and publish the stack and cost audit.",
+  "blockers": [
+    "None."
+  ],
+  "proof": {
+    "claims": [
+      "Each promoted stack layer has executable proof; independent acceptance and complete ordinary delegated outcomes remain unproven."
+    ],
+    "requirements": [
+      "cargo test --manifest-path crates/agentic-workspace-core/Cargo.toml",
+      "uv run --frozen --active --no-sync pytest tests/test_shared_core.py tests/test_external_operation_clients.py",
+      "AW selected proof for exact changed paths"
+    ],
+    "refs": []
+  },
+  "continuation": {
+    "owner": "delegation-lane-sweep",
+    "residual_intent": "Complete the useful delegation stack, preserve existing issue owners for partial outcomes, and report exact independent acceptance and supported-host limits."
+  },
+  "specialist_contracts": [
+    {
+      "kind": "planning-delegation/v1",
+      "target": "planning://delegation/keep-local",
+      "revision": 1
+    }
+  ],
+  "goal": [
+    "Exhaust coherent delegation lane through proved stacked PRs from reconstruct/foundation-contract: execution configurations, native continuity, bounded context, attributed lifecycle burden and conformance."
+  ],
+  "non_goals": [
+    "No merge, master modification, provider transcript store, session manager, global ranking or self-approval."
+  ],
+  "intent_continuity": {
+    "larger intended outcome": "Current source-owned best-fit delegation with constructible native continuity and attributed total-completion evidence.",
+    "this slice completes the larger intended outcome": "no",
+    "continuation surface": "Existing issues #2916 #2210 #2817 #2947 #2818 #2209 #2967 #2767 #2970 #2334 #2909; stack closeout map"
+  },
+  "execution_bounds": {
+    "allowed paths": "crates/agentic-workspace-core, src/agentic_workspace, tests, packages/planning, packages/verification, generated, scripts, docs, .agentic-workspace/planning/execplans/delegation-lane-sweep.plan.json",
+    "max changed files": "120 authored plus generated outputs across coherent layers",
+    "required validation commands": "AW selected proof per layer; Rust core tests; focused public Python/TypeScript parity; real installed Codex capability and execution evidence",
+    "ask-before-refactor threshold": "Unrelated owner redesign or genuinely unknowable human/domain semantics",
+    "stop before touching": "master, merges, human review approval, unrelated active Planning owners, provider transcripts"
+  },
+  "touched_paths": [
+    "crates/agentic-workspace-core",
+    "src/agentic_workspace",
+    "tests",
+    "generated",
+    "scripts",
+    "docs"
+  ],
+  "validation_commands": [
+    "cargo test --manifest-path crates/agentic-workspace-core/Cargo.toml",
+    "uv run --frozen --active --no-sync pytest tests/test_shared_core.py tests/test_external_operation_clients.py",
+    "AW selected proof for exact changed paths"
+  ],
+  "completion_criteria": [
+    "Each layer is independently reviewable with proof before stacking further.",
+    "Continuation capability and currentness fail closed; provider flags remain adapter owned.",
+    "Report exact merge order, partial versus closable issues, inherited failures and genuine blockers; independent PR review remains pending."
+  ],
+  "canonical_core": {
+    "hard_constraints": "No merge, master modification, provider transcript store, session manager, global ranking or self-approval. Preserve human-owned execution policy, keep provider refs local and opaque, and treat unknown cost as unknown.",
+    "agent_may_decide": "Choose coherent stack slices, bounded execution configurations and appropriate executable proof within the user-authorized delegation lane.",
+    "escalate_when": "A required semantic or domain decision cannot be inferred, independent acceptance is required, or an installed external capability cannot construct the needed action."
+  }
+}