@autonomos/core 0.6.0 → 0.7.0

package/README.md

@@ -8,7 +8,7 @@ This package contains the shared constants, types, templates, and parsers that d
 
 ## Features
 
-- **Constants**: Shared directory and file names (`.autonomos`, `manifest.json`, optional `specs/`, and `decisions/`)
+- **Constants**: Shared directory and file names (`.autonomos`, `manifest.json`, optional `archive/`, `specs/`, and `decisions/`)
 - **Templates**: Immutable templates for `PROTOCOL.md`, `TASKS.md`, `AGENT.md`, and `manifest.json`.
 - **Knowledge boundaries**: Markdown-first conventions for optional specifications and decision records (ADR), without requiring a parser.
 - **Types**: TypeScript definitions for protocol entities (Tasks, Agents, Manifest).
@@ -24,6 +24,26 @@ console.log(`Current Protocol Version: ${PROTOCOL_VERSION}`)
 const tasks = TaskParser.parse(markdownContent)
 ```
 
+## Current and Historical Task IDs
+
+```typescript
+import { readTaskRegistry } from '@autonomos/core'
+
+const registry = readTaskRegistry(projectRoot, { history: true })
+const reservedIds = new Set([...registry.current, ...registry.archived].map(task => task.id))
+// Do not allocate a new ID until registry.complete is true and duplicates are resolved.
+console.log(registry.duplicateIds, registry.warnings, reservedIds)
+```
+
+The default reads only the current task registry. Explicit history recursively
+reads `.autonomos/archive/**/TASKS.md`, without following symbolic links. References
+include ID, status, source path relative to the supplied root, and line number.
+`TaskParser.references` recognizes task IDs/status without optional metadata and
+ignores fenced examples; the existing detailed `TaskParser.parse` API is unchanged.
+`complete` describes the requested read, not semantic validity or task completion.
+The reader never mutates or decides which records are obsolete. Archives and their
+index remain project-owned Markdown; no CLI or Git is required for retrieval.
+
 ## Structure
 
 - `src/constants.ts`: Global constants and versioning.

package/dist/index.d.mts

@@ -5,7 +5,7 @@ import { z } from "zod";
  * Agent Protocol Specification Version (Independent of Package versions)
  * This refers to the schema and behavioral contract version.
  */
-declare const PROTOCOL_VERSION = "0.6.0-alpha";
+declare const PROTOCOL_VERSION = "0.7.0-alpha";
 /**
  * Directory name for Autonomos configuration
  */
@@ -38,6 +38,8 @@ declare const SPECS_DIR = "specs";
  * Optional project-owned directory for technical decision records (ADRs)
  */
 declare const DECISIONS_DIR = "decisions";
+/** Optional project-owned history, never loaded by default. */
+declare const ARCHIVE_DIR = "archive";
 //#endregion
 //#region src/schemas/harness-codes.d.ts
 /**
@@ -355,25 +357,25 @@ declare function parseManifest(content: string): Manifest;
 //#endregion
 //#region src/templates/protocol.d.ts
 /**
- * The Protocol kernel template — v0.6
+ * The Protocol kernel template — v0.7
  *
- * Design principles (v0.6):
+ * Design principles (v0.7):
  * - PROTOCOL.md is a compact REFERENCE, not an executable workflow.
  * - All step-by-step instructions live in the workflow files.
  * - No duplication between PROTOCOL.md and workflows.
  * - Short enough that an LLM can re-scan it mid-session without cost.
  */
-declare const PROTOCOL_TEMPLATE = "# AUTONOMOS PROTOCOL (v0.6.0-alpha)\n\n> This file defines the project's AI workflow contract. The workflows execute it. Do not duplicate workflow steps here.\n\n## Quick Reference\n\n| Action                           | How                                                                                |\n| -------------------------------- | ---------------------------------------------------------------------------------- |\n| Start a session                  | Read the `/session` workflow                                                       |\n| Start a task                     | Read the `/task` workflow                                                          |\n| Triage a problem or proposal     | Read the optional `/issue` workflow                                                |\n| Adopt existing project knowledge | Read the optional `/adopt` workflow                                                |\n| Audit accumulated drift          | Read the `/reconcile` workflow                                                     |\n| Design or critique a surface     | Read the optional `/design` workflow                                               |\n| End a session                    | Read the `/crystallize` workflow                                                   |\n| Get context                      | Read root `AGENT.md`, then only the selected scope's ancestor chain                |\n| Resolve objective                | Explicit user request first; otherwise resume `[/]` or pick highest-priority `[ ]` |\n| Log session work                 | Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md`                               |\n\n## File Map\n\n| File            | Location                   | Role                                              |\n| --------------- | -------------------------- | ------------------------------------------------- |\n| `AGENT.md`      | Root + any subdirectory    | Durable guidance for its directory scope          |\n| `TASKS.md`      | `.autonomos/TASKS.md`      | Single source of truth for task state             |\n| `ISSUES.md`     | `.autonomos/ISSUES.md`     | Optional problem, proposal, and question intake   |\n| `worklogs/`     | `.autonomos/worklogs/`     | Historical session evidence, not current guidance |\n| `specs/`        | `.autonomos/specs/`        | Optional project-owned normative target state     |\n| `decisions/`    | `.autonomos/decisions/`    | Optional project-owned decision records (ADRs)    |\n| `DESIGN.md`     | Root or target scope      | Optional project-owned visual/interaction direction |\n| `PROTOCOL.md`   | `.autonomos/PROTOCOL.md`   | This file \u2014 read-only reference                   |\n| `manifest.json` | `.autonomos/manifest.json` | Protocol version metadata                         |\n\n## Design Direction Boundary\n\n`DESIGN.md` is optional project-owned direction, not a managed protocol\nartifact. Use `/design` when a surface needs direction, critique, or\ndesign-knowledge extraction; keep the project's identity and examples local.\nThe workflow supplies routing and evidence rules, not a universal visual style.\n\n## AGENT.md Format Rules\n\nStore only stable guidance that will affect different future tasks. Keep transient evidence in worklogs and operational explanations in component documentation. Use the narrowest applicable `AGENT.md`; consolidate or replace obsolete entries instead of appending history.\n\n**Root `AGENT.md`** \u2014 Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).\n\n**Local `AGENT.md`** (in any subdirectory) \u2014 Free format. One line is enough if it is clear. What matters: the next session can use it. Example:\n\n```markdown\n# AGENT: packages/core\n\n- Stack: TypeScript, Vitest, tsdown\n- Conventions: exports via src/index.ts, tests co-located (\\*.test.ts)\n- Constraint: template changes require workflow test updates\n```\n\n## Issue, Specification, Decision, and Task Rules\n\nIssues describe evidence, impact, and a desired outcome without choosing implementation; proposed directions remain hypotheses until an approach is accepted. Specifications describe accepted target behavior or requirements that may guide multiple tasks. A decision record (commonly ADR, Architecture Decision Record) captures one technical choice and its rationale. Tasks describe an accepted intervention and completion criteria. Use optional `ISSUES.md`, `specs/`, and `decisions/` only when they provide value; direct, clear changes may become tasks immediately. Link related issues, specs, decisions, and tasks in both directions.\n\n## Specification and Decision Rules\n\n- `.autonomos/specs/` and `.autonomos/decisions/` are optional, project-owned, first-use directories; `init`, `update`, and artifact-integrity checks do not create or overwrite them.\n- Keep one Markdown file per bounded specification or decision. Include status, scope, provenance, acceptance criteria or consequences, and replacement links where relevant; no parser or independent version is required initially.\n- Specification status is `draft`, `accepted`, or `superseded`. Only `accepted` is normative; `superseded` points to its successor. Acceptance does not mean implementation is complete.\n- Decision records use `proposed`, `accepted`, or `superseded`; they preserve rationale and alternatives rather than duplicating the full specification.\n- Keep stable agent operating rules in `AGENT.md`, user/developer reference in `docs/`, execution state in `TASKS.md`, and historical evidence in `worklogs/`.\n- Read only relevant accepted records at task start. Use `/adopt` to extract legacy knowledge; never rewrite historical worklogs, issues, or tasks to create current artifacts.\n\nThe protocol-facing name is **decision record**. **ADR** (Architecture Decision Record) is a common convention for the same kind of document, not a required external standard. Use these lightweight Markdown shapes as a starting point; they are conventions, not parser-enforced schemas:\n\n```markdown\n# SPEC-001 \u2014 Concise target-state title\n\n- Status: draft | accepted | superseded\n- Scope: component, capability, or boundary\n- Provenance: issue, discussion, or source links\n- Related decisions: ADR-001, ...\n- Superseded by: SPEC-002 (when applicable)\n\n## Intent\n\n## Requirements\n\n## Acceptance criteria\n\n## Out of scope\n```\n\n```markdown\n# ADR-001 \u2014 Concise decision title\n\n- Status: proposed | accepted | superseded\n- Scope: component or technical boundary\n- Provenance: issue, task, or investigation links\n- Related specs: SPEC-001, ...\n- Superseded by: ADR-002 (when applicable)\n\n## Context\n\n## Decision\n\n## Alternatives considered\n\n## Consequences\n```\n\nOnly user/project governance accepts a specification or decision as normative. Agents may draft and link records, but must not silently promote them; acceptance is separate from implementation completion.\n\n## Task Format\n\n`- [Status] **[ID]** Title \\`Priority\\` \\`Complexity\\``\n\n| Status            | Priority      | Complexity |\n| ----------------- | ------------- | ---------- |\n| `[ ]` Todo        | `\uD83D\uDD34 Critical` | `S` Small  |\n| `[/]` In Progress | `\uD83D\uDFE0 High`     | `M` Medium |\n| `[x]` Done        | `\uD83D\uDD35 Medium`   | `L` Large  |\n| `[!]` Blocked     | `\u26AA Low`      | `XL` Huge  |\n\n## Metadata Rules\n\n- **Language:** English unless AGENT.md says otherwise.\n- **Tone:** Technical, concise, fact-based.\n- **Continuity:** Refer to previous work as \"we\" or \"the project\".\n";
+declare const PROTOCOL_TEMPLATE = "# AUTONOMOS PROTOCOL (v0.7.0-alpha)\n\n> This file defines the project's AI workflow contract. The workflows execute it. Do not duplicate workflow steps here.\n\n## Quick Reference\n\n| Action                           | How                                                                                |\n| -------------------------------- | ---------------------------------------------------------------------------------- |\n| Start a session                  | Read the `/session` workflow                                                       |\n| Start a task                     | Read the `/task` workflow                                                          |\n| Triage a problem or proposal     | Read the optional `/issue` workflow                                                |\n| Adopt existing project knowledge | Read the optional `/adopt` workflow                                                |\n| Reconcile drift and archive history          | Read the `/reconcile` workflow                                                     |\n| Design or critique a surface     | Read the optional `/design` workflow                                               |\n| End a session                    | Read the `/crystallize` workflow                                                   |\n| Get context                      | Read root `AGENT.md`, then only the selected scope's ancestor chain                |\n| Resolve objective                | Explicit user request first; otherwise resume `[/]` or pick highest-priority `[ ]` |\n| Log session work                 | Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md`                               |\n\n## File Map\n\n| File            | Location                   | Role                                              |\n| --------------- | -------------------------- | ------------------------------------------------- |\n| `AGENT.md`      | Root + any subdirectory    | Durable guidance for its directory scope          |\n| `TASKS.md`      | `.autonomos/TASKS.md`      | Current task state and optional Current direction             |\n| `ISSUES.md`     | `.autonomos/ISSUES.md`     | Optional problem, proposal, and question intake   |\n| `worklogs/`     | `.autonomos/worklogs/`     | Historical session evidence, not current guidance |\n| `archive/`     | `.autonomos/archive/`     | Optional history, searched only when justified     |\n| `specs/`        | `.autonomos/specs/`        | Optional project-owned normative target state     |\n| `decisions/`    | `.autonomos/decisions/`    | Optional project-owned decision records (ADRs)    |\n| `DESIGN.md`     | Root or target scope      | Optional project-owned visual/interaction direction |\n| `PROTOCOL.md`   | `.autonomos/PROTOCOL.md`   | This file \u2014 read-only reference                   |\n| `manifest.json` | `.autonomos/manifest.json` | Protocol version metadata                         |\n\n## Design Direction Boundary\n\n`DESIGN.md` is optional project-owned direction, not a managed protocol\nartifact. Use `/design` when a surface needs direction, critique, or\ndesign-knowledge extraction; keep the project's identity and examples local.\nThe workflow supplies routing and evidence rules, not a universal visual style.\n\n## AGENT.md Format Rules\n\nStore only stable guidance that will affect different future tasks. Keep transient evidence in worklogs and operational explanations in component documentation. Use the narrowest applicable `AGENT.md`; consolidate or replace obsolete entries instead of appending history. Preserve valid subclaims in mixed paragraphs. Check the resulting text for completed-action narratives, task progress and unsupported prohibitions; these do not belong in operating guidance.\n\n**Root `AGENT.md`** \u2014 Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).\n\n**Local `AGENT.md`** (in any subdirectory) \u2014 Free format. One line is enough if it is clear. What matters: the next session can use it. Example:\n\n```markdown\n# AGENT: packages/core\n\n- Stack: TypeScript, Vitest, tsdown\n- Conventions: exports via src/index.ts, tests co-located (\\*.test.ts)\n- Constraint: template changes require workflow test updates\n```\n\n## Issue, Specification, Decision, and Task Rules\n\nIssues describe evidence, impact, and a desired outcome without choosing implementation; proposed directions remain hypotheses until an approach is accepted. Specifications describe accepted target behavior or requirements that may guide multiple tasks. A decision record (commonly ADR, Architecture Decision Record) captures one technical choice and its rationale. Tasks describe an accepted intervention and completion criteria. Use optional `ISSUES.md`, `specs/`, and `decisions/` only when they provide value; direct, clear changes may become tasks immediately. Link related issues, specs, decisions, and tasks in both directions.\n\n## Specification and Decision Rules\n\n- `.autonomos/specs/` and `.autonomos/decisions/` are optional, project-owned, first-use directories; `init`, `update`, and artifact-integrity checks do not create or overwrite them.\n- Keep one Markdown file per bounded specification or decision. Include status, scope, provenance, acceptance criteria or consequences, and replacement links where relevant; no parser or independent version is required initially.\n- Specification status is `draft`, `accepted`, or `superseded`. Only `accepted` is normative; `superseded` points to its successor. Acceptance does not mean implementation is complete.\n- Decision records use `proposed`, `accepted`, or `superseded`; they preserve rationale and alternatives rather than duplicating the full specification.\n- Keep stable agent operating rules in `AGENT.md`, user/developer reference in `docs/`, execution state in `TASKS.md`, and historical evidence in `worklogs/`.\n- Read only relevant accepted records at task start. Use `/adopt` to extract legacy knowledge; never rewrite historical worklogs, issues, or tasks to create current artifacts.\n\nThe protocol-facing name is **decision record**. **ADR** (Architecture Decision Record) is a common convention for the same kind of document, not a required external standard. Use these lightweight Markdown shapes as a starting point; they are conventions, not parser-enforced schemas:\n\n```markdown\n# SPEC-001 \u2014 Concise target-state title\n\n- Status: draft | accepted | superseded\n- Scope: component, capability, or boundary\n- Provenance: issue, discussion, or source links\n- Related decisions: ADR-001, ...\n- Superseded by: SPEC-002 (when applicable)\n\n## Intent\n\n## Requirements\n\n## Acceptance criteria\n\n## Out of scope\n```\n\n```markdown\n# ADR-001 \u2014 Concise decision title\n\n- Status: proposed | accepted | superseded\n- Scope: component or technical boundary\n- Provenance: issue, task, or investigation links\n- Related specs: SPEC-001, ...\n- Superseded by: ADR-002 (when applicable)\n\n## Context\n\n## Decision\n\n## Alternatives considered\n\n## Consequences\n```\n\nOnly user/project governance accepts a specification or decision as normative. Agents may draft and link records, but must not silently promote them; acceptance is separate from implementation completion.\n\n## Current Context and Archival Lifecycle\n\n- Current context must support ordinary work without archives. Keep applicable guidance, accepted requirements/decisions, unresolved work, dependencies and necessary next actions discoverable. Acceptance is independent of implementation; dated temporary directives remain active until lifted or their stated end condition is met.\n- A completed task or resolved/declined issue is an archival candidate only when its own scope is settled and still-needed outcomes/constraints/references are retained in current context. Explicitly abandoned work may be archived with its reason, without claiming it was completed. A completed child does not satisfy unmet parent acceptance criteria.\n- Record new task completion dates as `Completed: YYYY-MM-DD`; do not infer missing old dates from worklog filenames. Age, a checkbox, absent code or a newer statement alone is not proof of obsolescence.\n- Group archival at coherent completed-work boundaries, not per task or calendar interval. No Sprint object or scheduled maintenance is required. Correct certain in-scope drift proactively during normal work; use `/reconcile` for investigation, consolidation and archival.\n- Before moving history, consolidate current knowledge in its existing narrowest home. Optional `Current direction` in `TASKS.md` explains present aims, recent consequential outcomes and next work; rewrite it rather than append chronology. Keep progress out of `AGENT.md`.\n- Create project-owned `.autonomos/archive/README.md` and meaningful batch directories on first use only. A batch can contain `TASKS.md`, `ISSUES.md`, `worklogs/` and provenance for retired guidance. Group/split batches by useful scope; there is no fixed age, size or mandatory per-record schema.\n- Archive means move, not delete or rewrite conclusions. Preserve historical record content, identifiers and provenance; repair relative paths when necessary. Preserve original mixed-source text when retiring only some claims. Applicable specs/decisions stay current independently of execution records. Extraction into new normative artifacts still uses `/adopt`.\n- The archive index maps batch topics to records, not a second task journal. Search by ID or subject only when a specific question requires history; neither archives nor their entire index are routine startup context. Keep only necessary dependency/outcome pointers in current records, not a permanent stub for every completed task.\n- Archived task and issue IDs remain reserved. Before assigning an ID, search current and archived registries. With a CLI, `readTaskRegistry(root, { history: true })` exposes task references and duplicates; plain Markdown search works without it.\n- Verify exact source text before edits, retained current knowledge, IDs and resolvable references after moves. Do not confuse tool annotations with file content or historical validation with a current observation. Re-read shared files before writing and preserve unrelated concurrent changes. Stop when a second pass yields no deterministic correction.\n- `autonomos status` summarizes the current task registry; `--history` adds separate archived counts and read/collision diagnostics. Archived means historical, not necessarily completed. History uses batch `TASKS.md` files, not arbitrary worklog checklists.\n- Archives are project-owned, like specs and decisions. Initialization, updates and integrity checks neither create empty archives nor overwrite, relocate or judge their contents. Installing a new protocol performs no automatic cleanup. Version-control policy stays project-owned; Git is not required for archival or retrieval.\n\nExample (only files needed by a batch are created):\n\n```text\n.autonomos/\n  TASKS.md\n  ISSUES.md\n  archive/\n    README.md\n    realtime-experiment-retirement/\n      TASKS.md\n      ISSUES.md\n      worklogs/\n```\n\n## Task Format\n\n`- [Status] **[ID]** Title \\`Priority\\` \\`Complexity\\``\n\n| Status            | Priority      | Complexity |\n| ----------------- | ------------- | ---------- |\n| `[ ]` Todo        | `\uD83D\uDD34 Critical` | `S` Small  |\n| `[/]` In Progress | `\uD83D\uDFE0 High`     | `M` Medium |\n| `[x]` Done        | `\uD83D\uDD35 Medium`   | `L` Large  |\n| `[!]` Blocked     | `\u26AA Low`      | `XL` Huge  |\n\n## Metadata Rules\n\n- **Language:** English unless AGENT.md says otherwise.\n- **Tone:** Technical, concise, fact-based.\n- **Continuity:** Refer to previous work as \"we\" or \"the project\".\n";
 /**
  * @deprecated Use PROTOCOL_TEMPLATE instead
  */
-declare const PROTOCOL_TEMPLATE_V2026_1 = "# AUTONOMOS PROTOCOL (v0.6.0-alpha)\n\n> This file defines the project's AI workflow contract. The workflows execute it. Do not duplicate workflow steps here.\n\n## Quick Reference\n\n| Action                           | How                                                                                |\n| -------------------------------- | ---------------------------------------------------------------------------------- |\n| Start a session                  | Read the `/session` workflow                                                       |\n| Start a task                     | Read the `/task` workflow                                                          |\n| Triage a problem or proposal     | Read the optional `/issue` workflow                                                |\n| Adopt existing project knowledge | Read the optional `/adopt` workflow                                                |\n| Audit accumulated drift          | Read the `/reconcile` workflow                                                     |\n| Design or critique a surface     | Read the optional `/design` workflow                                               |\n| End a session                    | Read the `/crystallize` workflow                                                   |\n| Get context                      | Read root `AGENT.md`, then only the selected scope's ancestor chain                |\n| Resolve objective                | Explicit user request first; otherwise resume `[/]` or pick highest-priority `[ ]` |\n| Log session work                 | Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md`                               |\n\n## File Map\n\n| File            | Location                   | Role                                              |\n| --------------- | -------------------------- | ------------------------------------------------- |\n| `AGENT.md`      | Root + any subdirectory    | Durable guidance for its directory scope          |\n| `TASKS.md`      | `.autonomos/TASKS.md`      | Single source of truth for task state             |\n| `ISSUES.md`     | `.autonomos/ISSUES.md`     | Optional problem, proposal, and question intake   |\n| `worklogs/`     | `.autonomos/worklogs/`     | Historical session evidence, not current guidance |\n| `specs/`        | `.autonomos/specs/`        | Optional project-owned normative target state     |\n| `decisions/`    | `.autonomos/decisions/`    | Optional project-owned decision records (ADRs)    |\n| `DESIGN.md`     | Root or target scope      | Optional project-owned visual/interaction direction |\n| `PROTOCOL.md`   | `.autonomos/PROTOCOL.md`   | This file \u2014 read-only reference                   |\n| `manifest.json` | `.autonomos/manifest.json` | Protocol version metadata                         |\n\n## Design Direction Boundary\n\n`DESIGN.md` is optional project-owned direction, not a managed protocol\nartifact. Use `/design` when a surface needs direction, critique, or\ndesign-knowledge extraction; keep the project's identity and examples local.\nThe workflow supplies routing and evidence rules, not a universal visual style.\n\n## AGENT.md Format Rules\n\nStore only stable guidance that will affect different future tasks. Keep transient evidence in worklogs and operational explanations in component documentation. Use the narrowest applicable `AGENT.md`; consolidate or replace obsolete entries instead of appending history.\n\n**Root `AGENT.md`** \u2014 Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).\n\n**Local `AGENT.md`** (in any subdirectory) \u2014 Free format. One line is enough if it is clear. What matters: the next session can use it. Example:\n\n```markdown\n# AGENT: packages/core\n\n- Stack: TypeScript, Vitest, tsdown\n- Conventions: exports via src/index.ts, tests co-located (\\*.test.ts)\n- Constraint: template changes require workflow test updates\n```\n\n## Issue, Specification, Decision, and Task Rules\n\nIssues describe evidence, impact, and a desired outcome without choosing implementation; proposed directions remain hypotheses until an approach is accepted. Specifications describe accepted target behavior or requirements that may guide multiple tasks. A decision record (commonly ADR, Architecture Decision Record) captures one technical choice and its rationale. Tasks describe an accepted intervention and completion criteria. Use optional `ISSUES.md`, `specs/`, and `decisions/` only when they provide value; direct, clear changes may become tasks immediately. Link related issues, specs, decisions, and tasks in both directions.\n\n## Specification and Decision Rules\n\n- `.autonomos/specs/` and `.autonomos/decisions/` are optional, project-owned, first-use directories; `init`, `update`, and artifact-integrity checks do not create or overwrite them.\n- Keep one Markdown file per bounded specification or decision. Include status, scope, provenance, acceptance criteria or consequences, and replacement links where relevant; no parser or independent version is required initially.\n- Specification status is `draft`, `accepted`, or `superseded`. Only `accepted` is normative; `superseded` points to its successor. Acceptance does not mean implementation is complete.\n- Decision records use `proposed`, `accepted`, or `superseded`; they preserve rationale and alternatives rather than duplicating the full specification.\n- Keep stable agent operating rules in `AGENT.md`, user/developer reference in `docs/`, execution state in `TASKS.md`, and historical evidence in `worklogs/`.\n- Read only relevant accepted records at task start. Use `/adopt` to extract legacy knowledge; never rewrite historical worklogs, issues, or tasks to create current artifacts.\n\nThe protocol-facing name is **decision record**. **ADR** (Architecture Decision Record) is a common convention for the same kind of document, not a required external standard. Use these lightweight Markdown shapes as a starting point; they are conventions, not parser-enforced schemas:\n\n```markdown\n# SPEC-001 \u2014 Concise target-state title\n\n- Status: draft | accepted | superseded\n- Scope: component, capability, or boundary\n- Provenance: issue, discussion, or source links\n- Related decisions: ADR-001, ...\n- Superseded by: SPEC-002 (when applicable)\n\n## Intent\n\n## Requirements\n\n## Acceptance criteria\n\n## Out of scope\n```\n\n```markdown\n# ADR-001 \u2014 Concise decision title\n\n- Status: proposed | accepted | superseded\n- Scope: component or technical boundary\n- Provenance: issue, task, or investigation links\n- Related specs: SPEC-001, ...\n- Superseded by: ADR-002 (when applicable)\n\n## Context\n\n## Decision\n\n## Alternatives considered\n\n## Consequences\n```\n\nOnly user/project governance accepts a specification or decision as normative. Agents may draft and link records, but must not silently promote them; acceptance is separate from implementation completion.\n\n## Task Format\n\n`- [Status] **[ID]** Title \\`Priority\\` \\`Complexity\\``\n\n| Status            | Priority      | Complexity |\n| ----------------- | ------------- | ---------- |\n| `[ ]` Todo        | `\uD83D\uDD34 Critical` | `S` Small  |\n| `[/]` In Progress | `\uD83D\uDFE0 High`     | `M` Medium |\n| `[x]` Done        | `\uD83D\uDD35 Medium`   | `L` Large  |\n| `[!]` Blocked     | `\u26AA Low`      | `XL` Huge  |\n\n## Metadata Rules\n\n- **Language:** English unless AGENT.md says otherwise.\n- **Tone:** Technical, concise, fact-based.\n- **Continuity:** Refer to previous work as \"we\" or \"the project\".\n";
+declare const PROTOCOL_TEMPLATE_V2026_1 = "# AUTONOMOS PROTOCOL (v0.7.0-alpha)\n\n> This file defines the project's AI workflow contract. The workflows execute it. Do not duplicate workflow steps here.\n\n## Quick Reference\n\n| Action                           | How                                                                                |\n| -------------------------------- | ---------------------------------------------------------------------------------- |\n| Start a session                  | Read the `/session` workflow                                                       |\n| Start a task                     | Read the `/task` workflow                                                          |\n| Triage a problem or proposal     | Read the optional `/issue` workflow                                                |\n| Adopt existing project knowledge | Read the optional `/adopt` workflow                                                |\n| Reconcile drift and archive history          | Read the `/reconcile` workflow                                                     |\n| Design or critique a surface     | Read the optional `/design` workflow                                               |\n| End a session                    | Read the `/crystallize` workflow                                                   |\n| Get context                      | Read root `AGENT.md`, then only the selected scope's ancestor chain                |\n| Resolve objective                | Explicit user request first; otherwise resume `[/]` or pick highest-priority `[ ]` |\n| Log session work                 | Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md`                               |\n\n## File Map\n\n| File            | Location                   | Role                                              |\n| --------------- | -------------------------- | ------------------------------------------------- |\n| `AGENT.md`      | Root + any subdirectory    | Durable guidance for its directory scope          |\n| `TASKS.md`      | `.autonomos/TASKS.md`      | Current task state and optional Current direction             |\n| `ISSUES.md`     | `.autonomos/ISSUES.md`     | Optional problem, proposal, and question intake   |\n| `worklogs/`     | `.autonomos/worklogs/`     | Historical session evidence, not current guidance |\n| `archive/`     | `.autonomos/archive/`     | Optional history, searched only when justified     |\n| `specs/`        | `.autonomos/specs/`        | Optional project-owned normative target state     |\n| `decisions/`    | `.autonomos/decisions/`    | Optional project-owned decision records (ADRs)    |\n| `DESIGN.md`     | Root or target scope      | Optional project-owned visual/interaction direction |\n| `PROTOCOL.md`   | `.autonomos/PROTOCOL.md`   | This file \u2014 read-only reference                   |\n| `manifest.json` | `.autonomos/manifest.json` | Protocol version metadata                         |\n\n## Design Direction Boundary\n\n`DESIGN.md` is optional project-owned direction, not a managed protocol\nartifact. Use `/design` when a surface needs direction, critique, or\ndesign-knowledge extraction; keep the project's identity and examples local.\nThe workflow supplies routing and evidence rules, not a universal visual style.\n\n## AGENT.md Format Rules\n\nStore only stable guidance that will affect different future tasks. Keep transient evidence in worklogs and operational explanations in component documentation. Use the narrowest applicable `AGENT.md`; consolidate or replace obsolete entries instead of appending history. Preserve valid subclaims in mixed paragraphs. Check the resulting text for completed-action narratives, task progress and unsupported prohibitions; these do not belong in operating guidance.\n\n**Root `AGENT.md`** \u2014 Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).\n\n**Local `AGENT.md`** (in any subdirectory) \u2014 Free format. One line is enough if it is clear. What matters: the next session can use it. Example:\n\n```markdown\n# AGENT: packages/core\n\n- Stack: TypeScript, Vitest, tsdown\n- Conventions: exports via src/index.ts, tests co-located (\\*.test.ts)\n- Constraint: template changes require workflow test updates\n```\n\n## Issue, Specification, Decision, and Task Rules\n\nIssues describe evidence, impact, and a desired outcome without choosing implementation; proposed directions remain hypotheses until an approach is accepted. Specifications describe accepted target behavior or requirements that may guide multiple tasks. A decision record (commonly ADR, Architecture Decision Record) captures one technical choice and its rationale. Tasks describe an accepted intervention and completion criteria. Use optional `ISSUES.md`, `specs/`, and `decisions/` only when they provide value; direct, clear changes may become tasks immediately. Link related issues, specs, decisions, and tasks in both directions.\n\n## Specification and Decision Rules\n\n- `.autonomos/specs/` and `.autonomos/decisions/` are optional, project-owned, first-use directories; `init`, `update`, and artifact-integrity checks do not create or overwrite them.\n- Keep one Markdown file per bounded specification or decision. Include status, scope, provenance, acceptance criteria or consequences, and replacement links where relevant; no parser or independent version is required initially.\n- Specification status is `draft`, `accepted`, or `superseded`. Only `accepted` is normative; `superseded` points to its successor. Acceptance does not mean implementation is complete.\n- Decision records use `proposed`, `accepted`, or `superseded`; they preserve rationale and alternatives rather than duplicating the full specification.\n- Keep stable agent operating rules in `AGENT.md`, user/developer reference in `docs/`, execution state in `TASKS.md`, and historical evidence in `worklogs/`.\n- Read only relevant accepted records at task start. Use `/adopt` to extract legacy knowledge; never rewrite historical worklogs, issues, or tasks to create current artifacts.\n\nThe protocol-facing name is **decision record**. **ADR** (Architecture Decision Record) is a common convention for the same kind of document, not a required external standard. Use these lightweight Markdown shapes as a starting point; they are conventions, not parser-enforced schemas:\n\n```markdown\n# SPEC-001 \u2014 Concise target-state title\n\n- Status: draft | accepted | superseded\n- Scope: component, capability, or boundary\n- Provenance: issue, discussion, or source links\n- Related decisions: ADR-001, ...\n- Superseded by: SPEC-002 (when applicable)\n\n## Intent\n\n## Requirements\n\n## Acceptance criteria\n\n## Out of scope\n```\n\n```markdown\n# ADR-001 \u2014 Concise decision title\n\n- Status: proposed | accepted | superseded\n- Scope: component or technical boundary\n- Provenance: issue, task, or investigation links\n- Related specs: SPEC-001, ...\n- Superseded by: ADR-002 (when applicable)\n\n## Context\n\n## Decision\n\n## Alternatives considered\n\n## Consequences\n```\n\nOnly user/project governance accepts a specification or decision as normative. Agents may draft and link records, but must not silently promote them; acceptance is separate from implementation completion.\n\n## Current Context and Archival Lifecycle\n\n- Current context must support ordinary work without archives. Keep applicable guidance, accepted requirements/decisions, unresolved work, dependencies and necessary next actions discoverable. Acceptance is independent of implementation; dated temporary directives remain active until lifted or their stated end condition is met.\n- A completed task or resolved/declined issue is an archival candidate only when its own scope is settled and still-needed outcomes/constraints/references are retained in current context. Explicitly abandoned work may be archived with its reason, without claiming it was completed. A completed child does not satisfy unmet parent acceptance criteria.\n- Record new task completion dates as `Completed: YYYY-MM-DD`; do not infer missing old dates from worklog filenames. Age, a checkbox, absent code or a newer statement alone is not proof of obsolescence.\n- Group archival at coherent completed-work boundaries, not per task or calendar interval. No Sprint object or scheduled maintenance is required. Correct certain in-scope drift proactively during normal work; use `/reconcile` for investigation, consolidation and archival.\n- Before moving history, consolidate current knowledge in its existing narrowest home. Optional `Current direction` in `TASKS.md` explains present aims, recent consequential outcomes and next work; rewrite it rather than append chronology. Keep progress out of `AGENT.md`.\n- Create project-owned `.autonomos/archive/README.md` and meaningful batch directories on first use only. A batch can contain `TASKS.md`, `ISSUES.md`, `worklogs/` and provenance for retired guidance. Group/split batches by useful scope; there is no fixed age, size or mandatory per-record schema.\n- Archive means move, not delete or rewrite conclusions. Preserve historical record content, identifiers and provenance; repair relative paths when necessary. Preserve original mixed-source text when retiring only some claims. Applicable specs/decisions stay current independently of execution records. Extraction into new normative artifacts still uses `/adopt`.\n- The archive index maps batch topics to records, not a second task journal. Search by ID or subject only when a specific question requires history; neither archives nor their entire index are routine startup context. Keep only necessary dependency/outcome pointers in current records, not a permanent stub for every completed task.\n- Archived task and issue IDs remain reserved. Before assigning an ID, search current and archived registries. With a CLI, `readTaskRegistry(root, { history: true })` exposes task references and duplicates; plain Markdown search works without it.\n- Verify exact source text before edits, retained current knowledge, IDs and resolvable references after moves. Do not confuse tool annotations with file content or historical validation with a current observation. Re-read shared files before writing and preserve unrelated concurrent changes. Stop when a second pass yields no deterministic correction.\n- `autonomos status` summarizes the current task registry; `--history` adds separate archived counts and read/collision diagnostics. Archived means historical, not necessarily completed. History uses batch `TASKS.md` files, not arbitrary worklog checklists.\n- Archives are project-owned, like specs and decisions. Initialization, updates and integrity checks neither create empty archives nor overwrite, relocate or judge their contents. Installing a new protocol performs no automatic cleanup. Version-control policy stays project-owned; Git is not required for archival or retrieval.\n\nExample (only files needed by a batch are created):\n\n```text\n.autonomos/\n  TASKS.md\n  ISSUES.md\n  archive/\n    README.md\n    realtime-experiment-retirement/\n      TASKS.md\n      ISSUES.md\n      worklogs/\n```\n\n## Task Format\n\n`- [Status] **[ID]** Title \\`Priority\\` \\`Complexity\\``\n\n| Status            | Priority      | Complexity |\n| ----------------- | ------------- | ---------- |\n| `[ ]` Todo        | `\uD83D\uDD34 Critical` | `S` Small  |\n| `[/]` In Progress | `\uD83D\uDFE0 High`     | `M` Medium |\n| `[x]` Done        | `\uD83D\uDD35 Medium`   | `L` Large  |\n| `[!]` Blocked     | `\u26AA Low`      | `XL` Huge  |\n\n## Metadata Rules\n\n- **Language:** English unless AGENT.md says otherwise.\n- **Tone:** Technical, concise, fact-based.\n- **Continuity:** Refer to previous work as \"we\" or \"the project\".\n";
 //#endregion
 //#region src/templates/tasks.d.ts
 /**
  * Template for TASKS.md - The task registry
  */
-declare const TASKS_TEMPLATE = "# PROJECT TASKS & ROADMAP\n\n> **LEGEND**\n> **Priority:** [\uD83D\uDD34 Critical] [\uD83D\uDFE0 High] [\uD83D\uDD35 Medium] [\u26AA Low]\n> **Complexity:** [S] Small (1h), [M] Medium (4h), [L] Large (1-2 days), [XL] Huge (Planning req.)\n> **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked\n\n## \uD83D\uDE80 Active Sprint\n\n- [ ] **[INIT-01]** Review project context and structure `Priority: \uD83D\uDD35` `Complexity: S`\n\n## \uD83D\uDD2E Backlog\n\n*(Add future tasks here)*\n";
+declare const TASKS_TEMPLATE = "# PROJECT TASKS & ROADMAP\n\n> **LEGEND**\n> **Priority:** [\uD83D\uDD34 Critical] [\uD83D\uDFE0 High] [\uD83D\uDD35 Medium] [\u26AA Low]\n> **Complexity:** [S] Small, [M] Medium, [L] Large, [XL] Huge (Planning required)\n> **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked\n\n## \uD83D\uDE80 Current work\n\n- [ ] **[INIT-01]** Review project context and structure `Priority: \uD83D\uDD35` `Complexity: S`\n\n## \uD83D\uDD2E Backlog\n\n*(Add future tasks here)*\n";
 //#endregion
 //#region src/templates/worklog.d.ts
 interface WorklogOptions {
@@ -476,10 +478,37 @@ declare function displayRelative(target: string, base: string): string;
 //#endregion
 //#region src/parsers/task-parser.d.ts
 declare class TaskParser {
+  /** Discover IDs/status without requiring optional priority or complexity metadata. */
+  static references(markdown: string): {
+    id: string;
+    status: TaskStatus;
+    line: number;
+  }[];
   static parse(markdown: string): Task[];
   private static mapStatus;
 }
 //#endregion
+//#region src/parsers/task-registry.d.ts
+interface TaskReference {
+  id: string;
+  status: ReturnType<typeof TaskParser.references>[number]['status'];
+  line: number;
+  /** Source path relative to the supplied project root. */
+  path: string;
+}
+interface TaskRegistry {
+  current: TaskReference[];
+  archived: TaskReference[];
+  duplicateIds: string[];
+  warnings: string[];
+  /** False if a requested registry could not be inspected completely. */
+  complete: boolean;
+}
+/** Read current task IDs; opt into history for reporting or reserving a new ID. */
+declare function readTaskRegistry(root: string, options?: {
+  history?: boolean;
+}): TaskRegistry;
+//#endregion
 //#region src/harness-codes.d.ts
 /**
  * Get a single harness entry by its id.
@@ -530,5 +559,5 @@ declare function resolveTargets(harnessIds: string[], cwd?: string): ResolvedTar
  */
 declare function getRawHarnessCodes(): HarnessCodes;
 //#endregion
-export { AGENT_FILE, AGENT_TEMPLATE, AUTONOMOS_DIR, AgentConfig, AgentContext, AgentParser, AgentSection, AncestorAgent, COMPLEXITIES, Complexity, DECISIONS_DIR, Harness, HarnessCodes, HarnessCodesSchema, HarnessSchema, Installer, InstallerSchema, LOCAL_AGENT_TEMPLATE, MANIFEST_FILE, Manifest, ManifestSchema, PRIORITIES, PROTOCOL_FILE, PROTOCOL_TEMPLATE, PROTOCOL_TEMPLATE_V2026_1, PROTOCOL_VERSION, Priority, ResolvedTarget, SPECS_DIR, TASKS_FILE, TASKS_TEMPLATE, Task, TaskParser, TaskStatus, WORKLOGS_DIR, createManifest, displayRelative, findAncestorAgents, findProjectRoot, generateAgentTemplate, generateLocalAgentTemplate, generateManifestContent, generateWorklogContent, getHarness, getRawHarnessCodes, isSamePath, listHarnesses, listPreferredHarnesses, mapTaskStatusToWorklogStatus, parseManifest, resolveTargets };
+export { AGENT_FILE, AGENT_TEMPLATE, ARCHIVE_DIR, AUTONOMOS_DIR, AgentConfig, AgentContext, AgentParser, AgentSection, AncestorAgent, COMPLEXITIES, Complexity, DECISIONS_DIR, Harness, HarnessCodes, HarnessCodesSchema, HarnessSchema, Installer, InstallerSchema, LOCAL_AGENT_TEMPLATE, MANIFEST_FILE, Manifest, ManifestSchema, PRIORITIES, PROTOCOL_FILE, PROTOCOL_TEMPLATE, PROTOCOL_TEMPLATE_V2026_1, PROTOCOL_VERSION, Priority, ResolvedTarget, SPECS_DIR, TASKS_FILE, TASKS_TEMPLATE, Task, TaskParser, TaskReference, TaskRegistry, TaskStatus, WORKLOGS_DIR, createManifest, displayRelative, findAncestorAgents, findProjectRoot, generateAgentTemplate, generateLocalAgentTemplate, generateManifestContent, generateWorklogContent, getHarness, getRawHarnessCodes, isSamePath, listHarnesses, listPreferredHarnesses, mapTaskStatusToWorklogStatus, parseManifest, readTaskRegistry, resolveTargets };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/constants.ts","../src/schemas/harness-codes.ts","../src/schemas/manifest.ts","../src/types.ts","../src/templates/agent.ts","../src/templates/manifest.ts","../src/templates/protocol.ts","../src/templates/tasks.ts","../src/templates/worklog.ts","../src/parsers/agent-finder.ts","../src/parsers/agent-parser.ts","../src/parsers/project-root.ts","../src/parsers/task-parser.ts","../src/harness-codes.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/constants.ts","../src/schemas/harness-codes.ts","../src/schemas/manifest.ts","../src/types.ts","../src/templates/agent.ts","../src/templates/manifest.ts","../src/templates/protocol.ts","../src/templates/tasks.ts","../src/templates/worklog.ts","../src/parsers/agent-finder.ts","../src/parsers/agent-parser.ts","../src/parsers/project-root.ts","../src/parsers/task-parser.ts","../src/parsers/task-registry.ts","../src/harness-codes.ts"],"mappings":";;;;;;AAIA;cAAa,gBAAA;;;AAAgB;cAKhB,aAAA;;;;cAKA,aAAA;AAAb;;;AAAA,cAKa,aAAA;AALa;AAK1B;;AAL0B,cAUb,UAAA;;AALa;AAK1B;cAKa,UAAA;;;AALU;cAUV,YAAA;;;;cAKA,SAAA;AALb;;;AAAA,cAUa,aAAA;AAVY;AAAA,cAaZ,WAAA;;;;;AA3Cb;;;;AAA6B;AAK7B;;;;AAA0B;cCKb,eAAA,EAAe,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmBf,aAAA,EAAa,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cASb,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAInB,SAAA,GAAY,CAAA,CAAE,KAAK,QAAQ,eAAA;AAAA,KAC3B,OAAA,GAAU,CAAA,CAAE,KAAK,QAAQ,aAAA;AAAA,KACzB,YAAA,GAAe,CAAA,CAAE,KAAK,QAAQ,kBAAA;;;;;AD5C1C;cECa,cAAA,EAAc,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;KAOf,QAAA,GAAW,CAAA,CAAE,KAAK,QAAQ,cAAA;;;;;;KCT1B,QAAA;;;;KAKA,UAAA;AHCZ;;;AAAA,KGIY,UAAA;AHJc;AAK1B;;AAL0B,UGST,IAAA;EACb,EAAA;EACA,KAAA;EACA,QAAA,EAAU,QAAA;EACV,UAAA,EAAY,UAAA;EACZ,MAAA,EAAQ,UAAA;EACR,WAAA;AAAA;AHAJ;;;AAAA,UGMiB,WAAA;EACb,IAAA;EACA,WAAA;EACA,KAAA;EACA,WAAA,GAAc,MAAM;AAAA;AAAA,UAGP,YAAA;EACb,KAAA;EACA,OAAO;AAAA;AAAA,UAGM,YAAA;EACb,KAAA;EACA,WAAA;EACA,QAAA,EAAU,YAAA;EACV,QAAA,GAAW,MAAM;AAAA;AAAA,cAGR,UAAA,EAAY,QAAQ;AAAA,cACpB,YAAA,EAAc,UAAU;;;;;;AH9CrC;iBIAgB,qBAAA,CAAsB,WAA+B;;;AJAxC;AAK7B;;iBIoCgB,0BAAA,CAA2B,OAAe;;AJpChC;AAK1B;cI2Ca,cAAA;;;AJ3Ca;cIgDb,oBAAA;;;;;AJ1Db;iBKEgB,cAAA,CAAe,UAAA,WAAqB,QAAQ;;;ALF/B;iBKeb,uBAAA,CAAwB,QAAkB,EAAR,QAAQ;;;;iBAO1C,aAAA,CAAc,OAAA,WAAkB,QAAQ;;;;;;ALtBxD;;;;AAA6B;AAK7B;cMEa,iBAAA;;;ANFa;cMkKb,yBAAA;;;;;;cCxKA,cAAA;;;UCDH,cAAA;EACN,MAAA;EACA,QAAA;EACA,IAAA;EACA,MAAA;EACA,WAAA;EACA,aAAA;EACA,SAAA;EACA,UAAA;EACA,SAAA;AAAA;ARFsB;AAK1B;;AAL0B,iBQQV,sBAAA,CAAuB,OAAuB,EAAd,cAAc;;ARHpC;AAK1B;iBQwBgB,4BAAA,CACZ,MAAkB,EAAV,UAAU;;;;;;ARxCtB;USKiB,aAAA;;EAEb,GAAA;ETPyB;ESSzB,IAAA;ETJsB;ESMtB,WAAA;AAAA;ATNsB;AAK1B;;;;AAA0B;AAK1B;;;;AAA0B;AAK1B;;;;AAAuB;AAKvB;;;AApB0B,iBS4BV,kBAAA,CACZ,MAAA,UACA,WAAA,YACD,aAAa;;;cCrCH,WAAA;;AVCb;;SUGW,KAAA,CAAM,QAAA,WAAmB,YAAY;AAAA;;;;;;AVHhD;;;;AAA6B;AAK7B;;;;AAA0B;AAK1B;;;;AAA0B;iBWuBV,eAAA,CAAgB,QAAgB;;;;AXlBtB;AAK1B;;iBWkCgB,UAAA,CAAW,CAAA,UAAW,CAAS;;AXlCxB;AAKvB;;;;AAAuB;iBWyCP,eAAA,CAAgB,MAAA,UAAgB,IAAY;;;cCpE/C,UAAA;;SAEF,UAAA,CAAW,QAAA;IAAqB,EAAA;IAAY,MAAA,EAAQ,UAAA;IAAY,IAAA;EAAA;EAAA,OA4BhE,KAAA,CAAM,QAAA,WAAmB,IAAI;EAAA,eAsBrB,SAAA;AAAA;;;UChDF,aAAA;EACb,EAAA;EACA,MAAA,EAAQ,UAAU,QAAQ,UAAA,CAAW,UAAA;EACrC,IAAA;;EAEA,IAAA;AAAA;AAAA,UAGa,YAAA;EACb,OAAA,EAAS,aAAA;EACT,QAAA,EAAU,aAAa;EACvB,YAAA;EACA,QAAA;EbJS;EaMT,QAAA;AAAA;;iBAIY,gBAAA,CAAiB,IAAA,UAAc,OAAA;EAAW,OAAA;AAAA,IAA2B,YAAY;;;;;AbpBjG;;iBccgB,UAAA,CAAW,EAAA,WAAa,OAAO;;AddlB;AAK7B;;iBcsBgB,aAAA,IAAiB,KAAK;EAAG,EAAA;EAAY,OAAA,EAAS,OAAA;AAAA;;;;iBAO9C,sBAAA,IAA0B,KAAK;EAAG,EAAA;EAAY,OAAA,EAAS,OAAA;AAAA;;AdnB7C;AAK1B;;UcsBiB,cAAA;EdtBM;EcwBnB,IAAA;EdnBS;EcqBT,aAAA;;EAEA,MAAA;AAAA;AdlBJ;;;;AAAyB;AAKzB;;;;AAAsB;AALtB,iBc+BgB,cAAA,CAAe,UAAA,YAAsB,GAAA,YAAoB,cAAc;;;;AdrB7D;iBc6EV,kBAAA,IAAsB,YAAY"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import{z as e}from"zod";import{existsSync as t,statSync as n}from"node:fs";import{dirname as r,isAbsolute as i,join as a,relative as o,resolve as s,sep as c}from"node:path";import l from"js-yaml";const u=`0.6.0-alpha`,d=`.autonomos`,f=`manifest.json`,p=`PROTOCOL.md`,m=`TASKS.md`,h=`AGENT.md`,ee=`worklogs`,g=`specs`,_=`decisions`,v=e.object({workflowsDir:e.string().optional(),targetDir:e.string().optional(),skillsDir:e.string().optional(),commandsDir:e.string().optional(),globalTargetDir:e.string().optional(),fileExtension:e.string()}).refine(e=>!!e.workflowsDir||!!e.targetDir||!!e.skillsDir,{message:"At least one of `workflowsDir`, `targetDir`, or `skillsDir` must be defined"}),y=e.object({name:e.string().min(1),preferred:e.boolean(),installer:v}),b=e.object({platforms:e.record(e.string(),y)}),x=e.object({protocolVersion:e.string().describe(`Version of the Agent Protocol specification`),cliVersion:e.string().describe(`Version of the CLI that last updated this project`),initializedAt:e.string().datetime().describe(`ISO timestamp of project initialization`),lastUpdated:e.string().datetime().describe(`ISO timestamp of last protocol update`)}),S=[`🔴 Critical`,`🟠 High`,`🔵 Medium`,`⚪ Low`],C=[`S`,`M`,`L`,`XL`];function w(e=`Project`){return`---
+import{z as e}from"zod";import{existsSync as t,lstatSync as n,readFileSync as r,readdirSync as i,statSync as a}from"node:fs";import{dirname as o,isAbsolute as s,join as c,relative as l,resolve as u,sep as d}from"node:path";import f from"js-yaml";const p=`0.7.0-alpha`,m=`.autonomos`,h=`manifest.json`,g=`PROTOCOL.md`,_=`TASKS.md`,v=`AGENT.md`,ee=`worklogs`,te=`specs`,y=`decisions`,b=`archive`,x=e.object({workflowsDir:e.string().optional(),targetDir:e.string().optional(),skillsDir:e.string().optional(),commandsDir:e.string().optional(),globalTargetDir:e.string().optional(),fileExtension:e.string()}).refine(e=>!!e.workflowsDir||!!e.targetDir||!!e.skillsDir,{message:"At least one of `workflowsDir`, `targetDir`, or `skillsDir` must be defined"}),S=e.object({name:e.string().min(1),preferred:e.boolean(),installer:x}),C=e.object({platforms:e.record(e.string(),S)}),w=e.object({protocolVersion:e.string().describe(`Version of the Agent Protocol specification`),cliVersion:e.string().describe(`Version of the CLI that last updated this project`),initializedAt:e.string().datetime().describe(`ISO timestamp of project initialization`),lastUpdated:e.string().datetime().describe(`ISO timestamp of last protocol update`)}),T=[`🔴 Critical`,`🟠 High`,`🔵 Medium`,`⚪ Low`],E=[`S`,`M`,`L`,`XL`];function D(e=`Project`){return`---
 name: "${e}"
 type: "project"
 status: "active"
@@ -30,13 +30,13 @@ status: "active"
 ## ⚠️ Known Constraints
 
 *List any technical debts, missing features, or external limitations.*
-`}function T(e){return`# AGENT: ${e}
+`}function O(e){return`# AGENT: ${e}
 
 - **Stack:** *(frameworks, libs specific to this module)*
 - **Conventions:** *(naming, exports, test patterns)*
 - **Constraints:** *(known issues, tech debt)*
-`}const te=w(),E=T(`module`);function D(e){let t=new Date().toISOString();return{protocolVersion:u,cliVersion:e,initializedAt:t,lastUpdated:t}}function O(e){return JSON.stringify(e,null,4)+`
-`}function k(e){let t=JSON.parse(e);return x.parse(t)}const A=`# AUTONOMOS PROTOCOL (v${u})
+`}const ne=D(),re=O(`module`);function k(e){let t=new Date().toISOString();return{protocolVersion:p,cliVersion:e,initializedAt:t,lastUpdated:t}}function A(e){return JSON.stringify(e,null,4)+`
+`}function j(e){let t=JSON.parse(e);return w.parse(t)}const M=`# AUTONOMOS PROTOCOL (v${p})
 
 > This file defines the project's AI workflow contract. The workflows execute it. Do not duplicate workflow steps here.
 
@@ -48,7 +48,7 @@ status: "active"
 | Start a task                     | Read the \`/task\` workflow                                                          |
 | Triage a problem or proposal     | Read the optional \`/issue\` workflow                                                |
 | Adopt existing project knowledge | Read the optional \`/adopt\` workflow                                                |
-| Audit accumulated drift          | Read the \`/reconcile\` workflow                                                     |
+| Reconcile drift and archive history          | Read the \`/reconcile\` workflow                                                     |
 | Design or critique a surface     | Read the optional \`/design\` workflow                                               |
 | End a session                    | Read the \`/crystallize\` workflow                                                   |
 | Get context                      | Read root \`AGENT.md\`, then only the selected scope's ancestor chain                |
@@ -60,9 +60,10 @@ status: "active"
 | File            | Location                   | Role                                              |
 | --------------- | -------------------------- | ------------------------------------------------- |
 | \`AGENT.md\`      | Root + any subdirectory    | Durable guidance for its directory scope          |
-| \`TASKS.md\`      | \`.autonomos/TASKS.md\`      | Single source of truth for task state             |
+| \`TASKS.md\`      | \`.autonomos/TASKS.md\`      | Current task state and optional Current direction             |
 | \`ISSUES.md\`     | \`.autonomos/ISSUES.md\`     | Optional problem, proposal, and question intake   |
 | \`worklogs/\`     | \`.autonomos/worklogs/\`     | Historical session evidence, not current guidance |
+| \`archive/\`     | \`.autonomos/archive/\`     | Optional history, searched only when justified     |
 | \`specs/\`        | \`.autonomos/specs/\`        | Optional project-owned normative target state     |
 | \`decisions/\`    | \`.autonomos/decisions/\`    | Optional project-owned decision records (ADRs)    |
 | \`DESIGN.md\`     | Root or target scope      | Optional project-owned visual/interaction direction |
@@ -78,7 +79,7 @@ The workflow supplies routing and evidence rules, not a universal visual style.
 
 ## AGENT.md Format Rules
 
-Store only stable guidance that will affect different future tasks. Keep transient evidence in worklogs and operational explanations in component documentation. Use the narrowest applicable \`AGENT.md\`; consolidate or replace obsolete entries instead of appending history.
+Store only stable guidance that will affect different future tasks. Keep transient evidence in worklogs and operational explanations in component documentation. Use the narrowest applicable \`AGENT.md\`; consolidate or replace obsolete entries instead of appending history. Preserve valid subclaims in mixed paragraphs. Check the resulting text for completed-action narratives, task progress and unsupported prohibitions; these do not belong in operating guidance.
 
 **Root \`AGENT.md\`** — Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).
 
@@ -145,6 +146,35 @@ The protocol-facing name is **decision record**. **ADR** (Architecture Decision
 
 Only user/project governance accepts a specification or decision as normative. Agents may draft and link records, but must not silently promote them; acceptance is separate from implementation completion.
 
+## Current Context and Archival Lifecycle
+
+- Current context must support ordinary work without archives. Keep applicable guidance, accepted requirements/decisions, unresolved work, dependencies and necessary next actions discoverable. Acceptance is independent of implementation; dated temporary directives remain active until lifted or their stated end condition is met.
+- A completed task or resolved/declined issue is an archival candidate only when its own scope is settled and still-needed outcomes/constraints/references are retained in current context. Explicitly abandoned work may be archived with its reason, without claiming it was completed. A completed child does not satisfy unmet parent acceptance criteria.
+- Record new task completion dates as \`Completed: YYYY-MM-DD\`; do not infer missing old dates from worklog filenames. Age, a checkbox, absent code or a newer statement alone is not proof of obsolescence.
+- Group archival at coherent completed-work boundaries, not per task or calendar interval. No Sprint object or scheduled maintenance is required. Correct certain in-scope drift proactively during normal work; use \`/reconcile\` for investigation, consolidation and archival.
+- Before moving history, consolidate current knowledge in its existing narrowest home. Optional \`Current direction\` in \`TASKS.md\` explains present aims, recent consequential outcomes and next work; rewrite it rather than append chronology. Keep progress out of \`AGENT.md\`.
+- Create project-owned \`.autonomos/archive/README.md\` and meaningful batch directories on first use only. A batch can contain \`TASKS.md\`, \`ISSUES.md\`, \`worklogs/\` and provenance for retired guidance. Group/split batches by useful scope; there is no fixed age, size or mandatory per-record schema.
+- Archive means move, not delete or rewrite conclusions. Preserve historical record content, identifiers and provenance; repair relative paths when necessary. Preserve original mixed-source text when retiring only some claims. Applicable specs/decisions stay current independently of execution records. Extraction into new normative artifacts still uses \`/adopt\`.
+- The archive index maps batch topics to records, not a second task journal. Search by ID or subject only when a specific question requires history; neither archives nor their entire index are routine startup context. Keep only necessary dependency/outcome pointers in current records, not a permanent stub for every completed task.
+- Archived task and issue IDs remain reserved. Before assigning an ID, search current and archived registries. With a CLI, \`readTaskRegistry(root, { history: true })\` exposes task references and duplicates; plain Markdown search works without it.
+- Verify exact source text before edits, retained current knowledge, IDs and resolvable references after moves. Do not confuse tool annotations with file content or historical validation with a current observation. Re-read shared files before writing and preserve unrelated concurrent changes. Stop when a second pass yields no deterministic correction.
+- \`autonomos status\` summarizes the current task registry; \`--history\` adds separate archived counts and read/collision diagnostics. Archived means historical, not necessarily completed. History uses batch \`TASKS.md\` files, not arbitrary worklog checklists.
+- Archives are project-owned, like specs and decisions. Initialization, updates and integrity checks neither create empty archives nor overwrite, relocate or judge their contents. Installing a new protocol performs no automatic cleanup. Version-control policy stays project-owned; Git is not required for archival or retrieval.
+
+Example (only files needed by a batch are created):
+
+\`\`\`text
+.autonomos/
+  TASKS.md
+  ISSUES.md
+  archive/
+    README.md
+    realtime-experiment-retirement/
+      TASKS.md
+      ISSUES.md
+      worklogs/
+\`\`\`
+
 ## Task Format
 
 \`- [Status] **[ID]** Title \\\`Priority\\\` \\\`Complexity\\\`\`
@@ -161,21 +191,21 @@ Only user/project governance accepts a specification or decision as normative. A
 - **Language:** English unless AGENT.md says otherwise.
 - **Tone:** Technical, concise, fact-based.
 - **Continuity:** Refer to previous work as "we" or "the project".
-`,j=A,M=`# PROJECT TASKS & ROADMAP
+`,N=M,P=`# PROJECT TASKS & ROADMAP
 
 > **LEGEND**
 > **Priority:** [🔴 Critical] [🟠 High] [🔵 Medium] [⚪ Low]
-> **Complexity:** [S] Small (1h), [M] Medium (4h), [L] Large (1-2 days), [XL] Huge (Planning req.)
+> **Complexity:** [S] Small, [M] Medium, [L] Large, [XL] Huge (Planning required)
 > **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked
 
-## 🚀 Active Sprint
+## 🚀 Current work
 
 - [ ] **[INIT-01]** Review project context and structure \`Priority: 🔵\` \`Complexity: S\`
 
 ## 🔮 Backlog
 
 *(Add future tasks here)*
-`;function N(e){let t=e.date??new Date().toISOString().split(`T`)[0];return`# WORKLOG: [${e.taskId}] ${e.taskName}
+`;function F(e){let t=e.date??new Date().toISOString().split(`T`)[0];return`# WORKLOG: [${e.taskId}] ${e.taskName}
 **Date:** ${t}
 **Agent Status:** [${e.status}]
 
@@ -196,7 +226,7 @@ ${e.challenges.map(e=>`  - ${e}`).join(`
 ## ⏭ Next Steps / Context for Successor
 ${e.nextSteps.map(e=>`- ${e}`).join(`
 `)}
-`}function P(e){switch(e){case`DONE`:return`Complete`;case`BLOCKED`:return`Blocked`;default:return`Partial`}}function F(e,n=process.cwd()){let c=s(n),l=I(e,c),u=o(c,l);if(u.startsWith(`..`)||i(u))throw Error(`Target "${e}" is outside the project root "${c}". findAncestorAgents only handles paths within the project.`);let d=L(z(l)?l:r(l),c),f=[];for(let e of d){let n=a(e,h);t(n)&&f.push({dir:e,path:n,relativeDir:R(e,c)})}return f}function I(e,t){return i(e)?e:a(t,e)}function L(e,t){let n=o(t,e);if(n===``||n===`.`)return[t];let r=n.split(c).filter(e=>e!==``&&e!==`.`),i=[t],s=t;for(let e of r)s=a(s,e),i.push(s);return i}function R(e,t){let n=o(t,e);return n===``?`.`:n}function z(e){try{return n(e).isDirectory()}catch{return!1}}var B=class{static parse(e){let t=e,n={},r=e.match(/^---\r?\n([\s\S]*?)\r?\n---/);if(r)try{n=l.load(r[1]),t=e.slice(r[0].length).trim()}catch(e){console.error(`Failed to parse Agent frontmatter:`,e)}let i=t.split(/\r?\n/),a=[],o=n.name??`Unknown Agent`,s=null,c=[];for(let e of i){if(e.startsWith(`# `)&&!n.name){let t=e.replace(`# `,``).trim();o=t.toUpperCase().startsWith(`AGENT CONTEXT:`)?t.slice(14).replace(/^[:\s-]+/,``).trim():t;continue}if(e.startsWith(`## `)){s&&(s.content=c.join(`
+`}function I(e){switch(e){case`DONE`:return`Complete`;case`BLOCKED`:return`Blocked`;default:return`Partial`}}function L(e,n=process.cwd()){let r=u(n),i=R(e,r),a=l(r,i);if(a.startsWith(`..`)||s(a))throw Error(`Target "${e}" is outside the project root "${r}". findAncestorAgents only handles paths within the project.`);let d=z(V(i)?i:o(i),r),f=[];for(let e of d){let n=c(e,v);t(n)&&f.push({dir:e,path:n,relativeDir:B(e,r)})}return f}function R(e,t){return s(e)?e:c(t,e)}function z(e,t){let n=l(t,e);if(n===``||n===`.`)return[t];let r=n.split(d).filter(e=>e!==``&&e!==`.`),i=[t],a=t;for(let e of r)a=c(a,e),i.push(a);return i}function B(e,t){let n=l(t,e);return n===``?`.`:n}function V(e){try{return a(e).isDirectory()}catch{return!1}}var H=class{static parse(e){let t=e,n={},r=e.match(/^---\r?\n([\s\S]*?)\r?\n---/);if(r)try{n=f.load(r[1]),t=e.slice(r[0].length).trim()}catch(e){console.error(`Failed to parse Agent frontmatter:`,e)}let i=t.split(/\r?\n/),a=[],o=n.name??`Unknown Agent`,s=null,c=[];for(let e of i){if(e.startsWith(`# `)&&!n.name){let t=e.replace(`# `,``).trim();o=t.toUpperCase().startsWith(`AGENT CONTEXT:`)?t.slice(14).replace(/^[:\s-]+/,``).trim():t;continue}if(e.startsWith(`## `)){s&&(s.content=c.join(`
 `).trim(),a.push(s)),s={title:e.replace(`## `,``).trim(),content:``},c=[];continue}s&&c.push(e)}return s&&(s.content=c.join(`
-`).trim(),a.push(s)),{title:o,sections:a,metadata:n}}};const V=[d,`.git`];function H(e){if(!e)return null;let n=s(e);for(;;){if(V.some(e=>t(a(n,e))))return n;let e=r(n);if(e===n)return null;n=e}}function U(e,t){return!e||!t?!1:s(e)===s(t)}function W(e,t){let n=o(t,e);return n===``||n===`.`?`.`:n.startsWith(`..${c}`)||n===`..`||i(n)?s(e):n}var G=class{static parse(e){let t=[],n=e.split(/\r?\n/),r=/- \[([ x/!])\] \*\*\[(.+)\]\*\* (.+) `Priority: (.+)` `Complexity: (.+)`/;for(let e of n){let n=e.match(r);if(n){let[,e=` `,r=``,i=``,a=``,o=``]=n;t.push({id:r,title:i.trim(),priority:a,complexity:o,status:this.mapStatus(e)})}}return t}static mapStatus(e){switch(e){case` `:return`TODO`;case`/`:return`IN_PROGRESS`;case`x`:return`DONE`;case`!`:return`BLOCKED`;default:return`TODO`}}};const K=b.parse({$schema:`./harness-codes.schema.json`,_comment:"Autonomos harness codes. Each entry tells `autonomos init` where to write the protocol workflow files. The shape is intentionally minimal: only what the installer needs. To add a new harness, add an entry here. To remove one, delete it. The schema is enforced at load time by Zod (see schemas/harness-codes.ts).",platforms:{cline:{name:`Cline`,preferred:!0,installer:{workflowsDir:`.clinerules/workflows`,fileExtension:`.md`,_note:"In Cline, a single .md file in .clinerules/workflows/ acts as both a workflow (auto-discovered via the frontmatter `description` field) and a slash command (invoked via /<name>)."}},"claude-code":{name:`Claude Code`,preferred:!0,installer:{workflowsDir:`.claude/skills`,commandsDir:`.claude/commands`,fileExtension:`.md`}},codex:{name:`Codex`,preferred:!0,installer:{workflowsDir:`.agents/skills`,fileExtension:`.md`,globalTargetDir:`~/.codex/skills`,_note:`OpenAI Codex. Uses the cross-tool .agents/skills/ standard.`}},antigravity:{name:`Antigravity`,preferred:!0,installer:{workflowsDir:`.agent/workflows`,fileExtension:`.md`,globalTargetDir:`~/.gemini/antigravity/skills`,_note:"Google Antigravity. Uses `.agent/workflows/` (not `.agent/skills/`). Singular `.agent/` (NOT the cross-tool `.agents/` standard). Cannot be deduplicated with the others."}},opencode:{name:`OpenCode`,preferred:!0,installer:{workflowsDir:`.agents/skills`,commandsDir:`.opencode/commands`,fileExtension:`.md`}},kilocode:{name:`KiloCode`,preferred:!0,installer:{workflowsDir:`.agents/skills`,fileExtension:`.md`,globalTargetDir:`~/.kilocode/skills`}}}});function q(e){let t=K.platforms[e];if(!t){let t=Object.keys(K.platforms).join(`, `);throw Error(`Unknown harness: "${e}". Known harnesses: ${t}`)}return t}function J(){return Object.entries(K.platforms).map(([e,t])=>({id:e,harness:t}))}function Y(){return J().filter(({harness:e})=>e.preferred)}function X(e,t=`.`){let n=new Map;for(let r of e){let{installer:e}=q(r);Z(n,e,r,t)}return Array.from(n.values())}function Z(e,t,n,r){let i=t.fileExtension;t.workflowsDir?Q(e,$(r,t.workflowsDir),i,n):t.targetDir?Q(e,$(r,t.targetDir),i,n):t.skillsDir&&Q(e,$(r,t.skillsDir),i,n),t.commandsDir&&Q(e,$(r,t.commandsDir),i,n)}function Q(e,t,n,r){let i=e.get(t);i?i.usedBy.includes(r)||i.usedBy.push(r):e.set(t,{path:t,fileExtension:n,usedBy:[r]})}function $(e,t){return e===`.`||e===``?t:t.startsWith(`/`)?`${e}${t}`:`${e}/${t}`}function ne(){return K}export{h as AGENT_FILE,te as AGENT_TEMPLATE,d as AUTONOMOS_DIR,B as AgentParser,C as COMPLEXITIES,_ as DECISIONS_DIR,b as HarnessCodesSchema,y as HarnessSchema,v as InstallerSchema,E as LOCAL_AGENT_TEMPLATE,f as MANIFEST_FILE,x as ManifestSchema,S as PRIORITIES,p as PROTOCOL_FILE,A as PROTOCOL_TEMPLATE,j as PROTOCOL_TEMPLATE_V2026_1,u as PROTOCOL_VERSION,g as SPECS_DIR,m as TASKS_FILE,M as TASKS_TEMPLATE,G as TaskParser,ee as WORKLOGS_DIR,D as createManifest,W as displayRelative,F as findAncestorAgents,H as findProjectRoot,w as generateAgentTemplate,T as generateLocalAgentTemplate,O as generateManifestContent,N as generateWorklogContent,q as getHarness,ne as getRawHarnessCodes,U as isSamePath,J as listHarnesses,Y as listPreferredHarnesses,P as mapTaskStatusToWorklogStatus,k as parseManifest,X as resolveTargets};
+`).trim(),a.push(s)),{title:o,sections:a,metadata:n}}};const U=[m,`.git`];function W(e){if(!e)return null;let n=u(e);for(;;){if(U.some(e=>t(c(n,e))))return n;let e=o(n);if(e===n)return null;n=e}}function G(e,t){return!e||!t?!1:u(e)===u(t)}function K(e,t){let n=l(t,e);return n===``||n===`.`?`.`:n.startsWith(`..${d}`)||n===`..`||s(n)?u(e):n}var q=class{static references(e){let t=[],n;for(let[r,i]of e.split(/\r?\n/).entries()){let e=i.match(/^\s{0,3}(`{3,}|~{3,})/);if(e?.[1]){n?e[1][0]===n[0]&&e[1].length>=n.length&&!i.slice(e[0].length).trim()&&(n=void 0):n=e[1];continue}if(n)continue;let a=i.match(/^\s*- \[([ x/!])\] \*\*\[([^\]]+)\]\*\*/);a?.[1]&&a[2]?.trim()&&t.push({id:a[2].trim(),status:this.mapStatus(a[1]),line:r+1})}return t}static parse(e){let t=[],n=e.split(/\r?\n/),r=/- \[([ x/!])\] \*\*\[(.+)\]\*\* (.+) `Priority: (.+)` `Complexity: (.+)`/;for(let e of n){let n=e.match(r);if(n){let[,e=` `,r=``,i=``,a=``,o=``]=n;t.push({id:r,title:i.trim(),priority:a,complexity:o,status:this.mapStatus(e)})}}return t}static mapStatus(e){switch(e){case` `:return`TODO`;case`/`:return`IN_PROGRESS`;case`x`:return`DONE`;case`!`:return`BLOCKED`;default:return`TODO`}}};function J(e,t={}){let a={current:[],archived:[],duplicateIds:[],warnings:[],complete:!0};function o(t,n){a.complete=!1,a.warnings.push(`${l(e,t)}: ${n}`)}function s(t,i){try{if(!n(t).isFile()){o(t,`Expected a regular task registry; symbolic links are not followed`);return}i.push(...q.references(r(t,`utf8`)).map(n=>({...n,path:l(e,t)})))}catch(e){o(t,e instanceof Error?e.message:String(e))}}function u(e,t=!1){try{if(!n(e).isDirectory()){o(e,`Expected an archive directory; symbolic links are not followed`);return}for(let t of i(e,{withFileTypes:!0}).sort((e,t)=>e.name.localeCompare(t.name))){let n=c(e,t.name);t.isSymbolicLink()?o(n,`Skipped symbolic link in archive`):t.isDirectory()?u(n):t.name===`TASKS.md`&&s(n,a.archived)}}catch(n){if(t&&n.code===`ENOENT`)return;o(e,n instanceof Error?n.message:String(n))}}let d=c(e,m);try{if(!n(d).isDirectory())return o(d,`Expected a regular project directory; symbolic links are not followed`),a}catch(e){return e.code!==`ENOENT`&&o(d,e instanceof Error?e.message:String(e)),a}let f=c(d,_);try{n(f),s(f,a.current)}catch(e){e.code!==`ENOENT`&&o(f,e instanceof Error?e.message:String(e))}t.history&&u(c(e,m,b),!0);let p=new Set,h=new Set;for(let e of[...a.current,...a.archived])p.has(e.id)&&h.add(e.id),p.add(e.id);return a.duplicateIds=[...h].sort(),a}const Y=C.parse({$schema:`./harness-codes.schema.json`,_comment:"Autonomos harness codes. Each entry tells `autonomos init` where to write the protocol workflow files. The shape is intentionally minimal: only what the installer needs. To add a new harness, add an entry here. To remove one, delete it. The schema is enforced at load time by Zod (see schemas/harness-codes.ts).",platforms:{cline:{name:`Cline`,preferred:!0,installer:{workflowsDir:`.clinerules/workflows`,fileExtension:`.md`,_note:"In Cline, a single .md file in .clinerules/workflows/ acts as both a workflow (auto-discovered via the frontmatter `description` field) and a slash command (invoked via /<name>)."}},"claude-code":{name:`Claude Code`,preferred:!0,installer:{workflowsDir:`.claude/skills`,commandsDir:`.claude/commands`,fileExtension:`.md`}},codex:{name:`Codex`,preferred:!0,installer:{workflowsDir:`.agents/skills`,fileExtension:`.md`,globalTargetDir:`~/.codex/skills`,_note:`OpenAI Codex. Uses the cross-tool .agents/skills/ standard.`}},antigravity:{name:`Antigravity`,preferred:!0,installer:{workflowsDir:`.agent/workflows`,fileExtension:`.md`,globalTargetDir:`~/.gemini/antigravity/skills`,_note:"Google Antigravity. Uses `.agent/workflows/` (not `.agent/skills/`). Singular `.agent/` (NOT the cross-tool `.agents/` standard). Cannot be deduplicated with the others."}},opencode:{name:`OpenCode`,preferred:!0,installer:{workflowsDir:`.agents/skills`,commandsDir:`.opencode/commands`,fileExtension:`.md`}},kilocode:{name:`KiloCode`,preferred:!0,installer:{workflowsDir:`.agents/skills`,fileExtension:`.md`,globalTargetDir:`~/.kilocode/skills`}}}});function X(e){let t=Y.platforms[e];if(!t){let t=Object.keys(Y.platforms).join(`, `);throw Error(`Unknown harness: "${e}". Known harnesses: ${t}`)}return t}function Z(){return Object.entries(Y.platforms).map(([e,t])=>({id:e,harness:t}))}function ie(){return Z().filter(({harness:e})=>e.preferred)}function ae(e,t=`.`){let n=new Map;for(let r of e){let{installer:e}=X(r);oe(n,e,r,t)}return Array.from(n.values())}function oe(e,t,n,r){let i=t.fileExtension;t.workflowsDir?Q(e,$(r,t.workflowsDir),i,n):t.targetDir?Q(e,$(r,t.targetDir),i,n):t.skillsDir&&Q(e,$(r,t.skillsDir),i,n),t.commandsDir&&Q(e,$(r,t.commandsDir),i,n)}function Q(e,t,n,r){let i=e.get(t);i?i.usedBy.includes(r)||i.usedBy.push(r):e.set(t,{path:t,fileExtension:n,usedBy:[r]})}function $(e,t){return e===`.`||e===``?t:t.startsWith(`/`)?`${e}${t}`:`${e}/${t}`}function se(){return Y}export{v as AGENT_FILE,ne as AGENT_TEMPLATE,b as ARCHIVE_DIR,m as AUTONOMOS_DIR,H as AgentParser,E as COMPLEXITIES,y as DECISIONS_DIR,C as HarnessCodesSchema,S as HarnessSchema,x as InstallerSchema,re as LOCAL_AGENT_TEMPLATE,h as MANIFEST_FILE,w as ManifestSchema,T as PRIORITIES,g as PROTOCOL_FILE,M as PROTOCOL_TEMPLATE,N as PROTOCOL_TEMPLATE_V2026_1,p as PROTOCOL_VERSION,te as SPECS_DIR,_ as TASKS_FILE,P as TASKS_TEMPLATE,q as TaskParser,ee as WORKLOGS_DIR,k as createManifest,K as displayRelative,L as findAncestorAgents,W as findProjectRoot,D as generateAgentTemplate,O as generateLocalAgentTemplate,A as generateManifestContent,F as generateWorklogContent,X as getHarness,se as getRawHarnessCodes,G as isSamePath,Z as listHarnesses,ie as listPreferredHarnesses,I as mapTaskStatusToWorklogStatus,j as parseManifest,J as readTaskRegistry,ae as resolveTargets};
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["harnessCodesData"],"sources":["../src/constants.ts","../src/schemas/harness-codes.ts","../src/schemas/manifest.ts","../src/types.ts","../src/templates/agent.ts","../src/templates/manifest.ts","../src/templates/protocol.ts","../src/templates/tasks.ts","../src/templates/worklog.ts","../src/parsers/agent-finder.ts","../src/parsers/agent-parser.ts","../src/parsers/project-root.ts","../src/parsers/task-parser.ts","../src/data/harness-codes.json","../src/harness-codes.ts"],"sourcesContent":["/**\n * Agent Protocol Specification Version (Independent of Package versions)\n * This refers to the schema and behavioral contract version.\n */\nexport const PROTOCOL_VERSION = '0.6.0-alpha'\n\n/**\n * Directory name for Autonomos configuration\n */\nexport const AUTONOMOS_DIR = '.autonomos'\n\n/**\n * Manifest filename\n */\nexport const MANIFEST_FILE = 'manifest.json'\n\n/**\n * Protocol filename\n */\nexport const PROTOCOL_FILE = 'PROTOCOL.md'\n\n/**\n * Tasks filename\n */\nexport const TASKS_FILE = 'TASKS.md'\n\n/**\n * Agent context filename (at project root)\n */\nexport const AGENT_FILE = 'AGENT.md'\n\n/**\n * Worklogs directory name\n */\nexport const WORKLOGS_DIR = 'worklogs'\n\n/**\n * Optional project-owned directory for durable target-state specifications\n */\nexport const SPECS_DIR = 'specs'\n\n/**\n * Optional project-owned directory for technical decision records (ADRs)\n */\nexport const DECISIONS_DIR = 'decisions'\n","import { z } from 'zod'\n\n/**\n * Installer configuration for a single harness.\n *\n * At least one of `workflowsDir`, `targetDir`, or `skillsDir` must be defined.\n *\n * - `workflowsDir`: Where the protocol workflow files are written.\n *    Preferred field — used by most harnesses.\n * - `targetDir`: Single directory (legacy, like Cline's .clinerules/workflows/).\n * - `skillsDir`: Skills directory (legacy, for harnesses that don't distinguish\n *    skills from workflows).\n * - `commandsDir`: Additional commands directory (optional).\n */\nexport const InstallerSchema = z\n    .object({\n        workflowsDir: z.string().optional(),\n        targetDir: z.string().optional(),\n        skillsDir: z.string().optional(),\n        commandsDir: z.string().optional(),\n        globalTargetDir: z.string().optional(),\n        fileExtension: z.string(),\n    })\n    .refine(\n        data => Boolean(data.workflowsDir) || Boolean(data.targetDir) || Boolean(data.skillsDir),\n        {\n            message: 'At least one of `workflowsDir`, `targetDir`, or `skillsDir` must be defined',\n        }\n    )\n\n/**\n * A single harness entry.\n */\nexport const HarnessSchema = z.object({\n    name: z.string().min(1),\n    preferred: z.boolean(),\n    installer: InstallerSchema,\n})\n\n/**\n * Root schema for the harness-codes configuration file.\n */\nexport const HarnessCodesSchema = z.object({\n    platforms: z.record(z.string(), HarnessSchema),\n})\n\nexport type Installer = z.infer<typeof InstallerSchema>\nexport type Harness = z.infer<typeof HarnessSchema>\nexport type HarnessCodes = z.infer<typeof HarnessCodesSchema>\n","import { z } from 'zod'\n\n/**\n * Manifest Schema for .autonomos/manifest.json\n */\nexport const ManifestSchema = z.object({\n    protocolVersion: z.string().describe('Version of the Agent Protocol specification'),\n    cliVersion: z.string().describe('Version of the CLI that last updated this project'),\n    initializedAt: z.string().datetime().describe('ISO timestamp of project initialization'),\n    lastUpdated: z.string().datetime().describe('ISO timestamp of last protocol update'),\n})\n\nexport type Manifest = z.infer<typeof ManifestSchema>\n","/**\n * Priority levels for tasks\n */\nexport type Priority = '🔴 Critical' | '🟠 High' | '🔵 Medium' | '⚪ Low'\n\n/**\n * Complexity estimates for tasks\n */\nexport type Complexity = 'S' | 'M' | 'L' | 'XL'\n\n/**\n * Task status markers\n */\nexport type TaskStatus = 'TODO' | 'IN_PROGRESS' | 'DONE' | 'BLOCKED'\n\n/**\n * Task entity parsed from TASKS.md\n */\nexport interface Task {\n    id: string\n    title: string\n    priority: Priority\n    complexity: Complexity\n    status: TaskStatus\n    worklogPath?: string\n}\n\n/**\n * Agent configuration parsed from AGENT.md\n */\nexport interface AgentConfig {\n    name: string\n    description?: string\n    stack: string[]\n    preferences?: Record<string, any>\n}\n\nexport interface AgentSection {\n    title: string\n    content: string\n}\n\nexport interface AgentContext {\n    title: string\n    description?: string\n    sections: AgentSection[]\n    metadata?: Record<string, any>\n}\n\nexport const PRIORITIES: Priority[] = ['🔴 Critical', '🟠 High', '🔵 Medium', '⚪ Low']\nexport const COMPLEXITIES: Complexity[] = ['S', 'M', 'L', 'XL']\n","/**\n * Template for AGENT.md - The context anchor at project root\n * @param projectName - Name of the project to personalize the template\n */\nexport function generateAgentTemplate(projectName: string = 'Project'): string {\n    return `---\nname: \"${projectName}\"\ntype: \"project\"\nstatus: \"active\"\n---\n# AGENT CONTEXT: ${projectName}\n\n## 🧠 Context & Objectives\n\n*Describe what this project does and its main goals.*\n\n## ⚙️ Workflow & Preferences\n\n- **Commits:** Conventional Commits\n- **Language:** English\n- **Design:** If present, read root \\`DESIGN.md\\` before changing a user-facing surface; use \\`/design\\` for new direction, critique, or design-knowledge extraction.\n\n## 🏗 Stack & Architecture\n\n- **Tech:** *(List frameworks, libraries)*\n- **Patterns:** *(Architecture patterns used)*\n\n## 📁 Key Directories\n\n| Path | Description |\n|------|-------------|\n| \\`src/\\` | Source code |\n| \\`.autonomos/\\` | Agent Protocol files |\n\n## ⚠️ Known Constraints\n\n*List any technical debts, missing features, or external limitations.*\n`\n}\n\n/**\n * Generate a minimal local AGENT.md for subdirectories.\n * Free format by design — low friction encourages creation.\n * @param dirName - Name of the directory\n */\nexport function generateLocalAgentTemplate(dirName: string): string {\n    return `# AGENT: ${dirName}\n\n- **Stack:** *(frameworks, libs specific to this module)*\n- **Conventions:** *(naming, exports, test patterns)*\n- **Constraints:** *(known issues, tech debt)*\n`\n}\n\n/**\n * Default root AGENT.md template\n */\nexport const AGENT_TEMPLATE = generateAgentTemplate()\n\n/**\n * Default local AGENT.md template\n */\nexport const LOCAL_AGENT_TEMPLATE = generateLocalAgentTemplate('module')\n","import { PROTOCOL_VERSION } from '../constants'\nimport { ManifestSchema, type Manifest } from '../schemas/manifest'\n\n/**\n * Creates a new manifest object with current timestamps\n */\nexport function createManifest(cliVersion: string): Manifest {\n    const now = new Date().toISOString()\n    return {\n        protocolVersion: PROTOCOL_VERSION,\n        cliVersion,\n        initializedAt: now,\n        lastUpdated: now,\n    }\n}\n\n/**\n * Generates the manifest.json content as a formatted string\n */\nexport function generateManifestContent(manifest: Manifest): string {\n    return JSON.stringify(manifest, null, 4) + '\\n'\n}\n\n/**\n * Parses manifest.json content into a Manifest object with validation\n */\nexport function parseManifest(content: string): Manifest {\n    const data = JSON.parse(content)\n    return ManifestSchema.parse(data)\n}\n","import { PROTOCOL_VERSION } from '../constants'\n\n/**\n * The Protocol kernel template — v0.6\n *\n * Design principles (v0.6):\n * - PROTOCOL.md is a compact REFERENCE, not an executable workflow.\n * - All step-by-step instructions live in the workflow files.\n * - No duplication between PROTOCOL.md and workflows.\n * - Short enough that an LLM can re-scan it mid-session without cost.\n */\nexport const PROTOCOL_TEMPLATE = `# AUTONOMOS PROTOCOL (v${PROTOCOL_VERSION})\n\n> This file defines the project's AI workflow contract. The workflows execute it. Do not duplicate workflow steps here.\n\n## Quick Reference\n\n| Action                           | How                                                                                |\n| -------------------------------- | ---------------------------------------------------------------------------------- |\n| Start a session                  | Read the \\`/session\\` workflow                                                       |\n| Start a task                     | Read the \\`/task\\` workflow                                                          |\n| Triage a problem or proposal     | Read the optional \\`/issue\\` workflow                                                |\n| Adopt existing project knowledge | Read the optional \\`/adopt\\` workflow                                                |\n| Audit accumulated drift          | Read the \\`/reconcile\\` workflow                                                     |\n| Design or critique a surface     | Read the optional \\`/design\\` workflow                                               |\n| End a session                    | Read the \\`/crystallize\\` workflow                                                   |\n| Get context                      | Read root \\`AGENT.md\\`, then only the selected scope's ancestor chain                |\n| Resolve objective                | Explicit user request first; otherwise resume \\`[/]\\` or pick highest-priority \\`[ ]\\` |\n| Log session work                 | Create \\`.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md\\`                               |\n\n## File Map\n\n| File            | Location                   | Role                                              |\n| --------------- | -------------------------- | ------------------------------------------------- |\n| \\`AGENT.md\\`      | Root + any subdirectory    | Durable guidance for its directory scope          |\n| \\`TASKS.md\\`      | \\`.autonomos/TASKS.md\\`      | Single source of truth for task state             |\n| \\`ISSUES.md\\`     | \\`.autonomos/ISSUES.md\\`     | Optional problem, proposal, and question intake   |\n| \\`worklogs/\\`     | \\`.autonomos/worklogs/\\`     | Historical session evidence, not current guidance |\n| \\`specs/\\`        | \\`.autonomos/specs/\\`        | Optional project-owned normative target state     |\n| \\`decisions/\\`    | \\`.autonomos/decisions/\\`    | Optional project-owned decision records (ADRs)    |\n| \\`DESIGN.md\\`     | Root or target scope      | Optional project-owned visual/interaction direction |\n| \\`PROTOCOL.md\\`   | \\`.autonomos/PROTOCOL.md\\`   | This file — read-only reference                   |\n| \\`manifest.json\\` | \\`.autonomos/manifest.json\\` | Protocol version metadata                         |\n\n## Design Direction Boundary\n\n\\`DESIGN.md\\` is optional project-owned direction, not a managed protocol\nartifact. Use \\`/design\\` when a surface needs direction, critique, or\ndesign-knowledge extraction; keep the project's identity and examples local.\nThe workflow supplies routing and evidence rules, not a universal visual style.\n\n## AGENT.md Format Rules\n\nStore only stable guidance that will affect different future tasks. Keep transient evidence in worklogs and operational explanations in component documentation. Use the narrowest applicable \\`AGENT.md\\`; consolidate or replace obsolete entries instead of appending history.\n\n**Root \\`AGENT.md\\`** — Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).\n\n**Local \\`AGENT.md\\`** (in any subdirectory) — Free format. One line is enough if it is clear. What matters: the next session can use it. Example:\n\n\\`\\`\\`markdown\n# AGENT: packages/core\n\n- Stack: TypeScript, Vitest, tsdown\n- Conventions: exports via src/index.ts, tests co-located (\\\\*.test.ts)\n- Constraint: template changes require workflow test updates\n\\`\\`\\`\n\n## Issue, Specification, Decision, and Task Rules\n\nIssues describe evidence, impact, and a desired outcome without choosing implementation; proposed directions remain hypotheses until an approach is accepted. Specifications describe accepted target behavior or requirements that may guide multiple tasks. A decision record (commonly ADR, Architecture Decision Record) captures one technical choice and its rationale. Tasks describe an accepted intervention and completion criteria. Use optional \\`ISSUES.md\\`, \\`specs/\\`, and \\`decisions/\\` only when they provide value; direct, clear changes may become tasks immediately. Link related issues, specs, decisions, and tasks in both directions.\n\n## Specification and Decision Rules\n\n- \\`.autonomos/specs/\\` and \\`.autonomos/decisions/\\` are optional, project-owned, first-use directories; \\`init\\`, \\`update\\`, and artifact-integrity checks do not create or overwrite them.\n- Keep one Markdown file per bounded specification or decision. Include status, scope, provenance, acceptance criteria or consequences, and replacement links where relevant; no parser or independent version is required initially.\n- Specification status is \\`draft\\`, \\`accepted\\`, or \\`superseded\\`. Only \\`accepted\\` is normative; \\`superseded\\` points to its successor. Acceptance does not mean implementation is complete.\n- Decision records use \\`proposed\\`, \\`accepted\\`, or \\`superseded\\`; they preserve rationale and alternatives rather than duplicating the full specification.\n- Keep stable agent operating rules in \\`AGENT.md\\`, user/developer reference in \\`docs/\\`, execution state in \\`TASKS.md\\`, and historical evidence in \\`worklogs/\\`.\n- Read only relevant accepted records at task start. Use \\`/adopt\\` to extract legacy knowledge; never rewrite historical worklogs, issues, or tasks to create current artifacts.\n\nThe protocol-facing name is **decision record**. **ADR** (Architecture Decision Record) is a common convention for the same kind of document, not a required external standard. Use these lightweight Markdown shapes as a starting point; they are conventions, not parser-enforced schemas:\n\n\\`\\`\\`markdown\n# SPEC-001 — Concise target-state title\n\n- Status: draft | accepted | superseded\n- Scope: component, capability, or boundary\n- Provenance: issue, discussion, or source links\n- Related decisions: ADR-001, ...\n- Superseded by: SPEC-002 (when applicable)\n\n## Intent\n\n## Requirements\n\n## Acceptance criteria\n\n## Out of scope\n\\`\\`\\`\n\n\\`\\`\\`markdown\n# ADR-001 — Concise decision title\n\n- Status: proposed | accepted | superseded\n- Scope: component or technical boundary\n- Provenance: issue, task, or investigation links\n- Related specs: SPEC-001, ...\n- Superseded by: ADR-002 (when applicable)\n\n## Context\n\n## Decision\n\n## Alternatives considered\n\n## Consequences\n\\`\\`\\`\n\nOnly user/project governance accepts a specification or decision as normative. Agents may draft and link records, but must not silently promote them; acceptance is separate from implementation completion.\n\n## Task Format\n\n\\`- [Status] **[ID]** Title \\\\\\`Priority\\\\\\` \\\\\\`Complexity\\\\\\`\\`\n\n| Status            | Priority      | Complexity |\n| ----------------- | ------------- | ---------- |\n| \\`[ ]\\` Todo        | \\`🔴 Critical\\` | \\`S\\` Small  |\n| \\`[/]\\` In Progress | \\`🟠 High\\`     | \\`M\\` Medium |\n| \\`[x]\\` Done        | \\`🔵 Medium\\`   | \\`L\\` Large  |\n| \\`[!]\\` Blocked     | \\`⚪ Low\\`      | \\`XL\\` Huge  |\n\n## Metadata Rules\n\n- **Language:** English unless AGENT.md says otherwise.\n- **Tone:** Technical, concise, fact-based.\n- **Continuity:** Refer to previous work as \"we\" or \"the project\".\n`\n\n/**\n * @deprecated Use PROTOCOL_TEMPLATE instead\n */\nexport const PROTOCOL_TEMPLATE_V2026_1 = PROTOCOL_TEMPLATE\n","/**\n * Template for TASKS.md - The task registry\n */\nexport const TASKS_TEMPLATE = `# PROJECT TASKS & ROADMAP\n\n> **LEGEND**\n> **Priority:** [🔴 Critical] [🟠 High] [🔵 Medium] [⚪ Low]\n> **Complexity:** [S] Small (1h), [M] Medium (4h), [L] Large (1-2 days), [XL] Huge (Planning req.)\n> **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked\n\n## 🚀 Active Sprint\n\n- [ ] **[INIT-01]** Review project context and structure \\`Priority: 🔵\\` \\`Complexity: S\\`\n\n## 🔮 Backlog\n\n*(Add future tasks here)*\n`\n","import type { TaskStatus } from '../types'\n\ninterface WorklogOptions {\n    taskId: string\n    taskName: string\n    date?: string\n    status: 'Complete' | 'Partial' | 'Blocked'\n    description: string\n    filesModified: string[]\n    decisions: string[]\n    challenges: string[]\n    nextSteps: string[]\n}\n\n/**\n * Generate a Worklog markdown content\n */\nexport function generateWorklogContent(options: WorklogOptions): string {\n    const date = options.date ?? new Date().toISOString().split('T')[0]\n\n    return `# WORKLOG: [${options.taskId}] ${options.taskName}\n**Date:** ${date}\n**Agent Status:** [${options.status}]\n\n## 📝 Description\n${options.description}\n\n## 🛠 Technical Details\n- **Files Modified:**\n${options.filesModified.map(f => `  - ${f}`).join('\\n')}\n- **Key Decisions:**\n${options.decisions.map(d => `  - ${d}`).join('\\n')}\n- **Challenges:**\n${options.challenges.map(c => `  - ${c}`).join('\\n')}\n\n## ⏭ Next Steps / Context for Successor\n${options.nextSteps.map(s => `- ${s}`).join('\\n')}\n`\n}\n\n/**\n * Common status mapping for worklogs\n */\nexport function mapTaskStatusToWorklogStatus(\n    status: TaskStatus\n): 'Complete' | 'Partial' | 'Blocked' {\n    switch (status) {\n        case 'DONE':\n            return 'Complete'\n        case 'BLOCKED':\n            return 'Blocked'\n        default:\n            return 'Partial'\n    }\n}\n","import { existsSync, statSync } from 'node:fs'\nimport { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path'\n\nimport { AGENT_FILE } from '../constants'\n\n/**\n * Result of an ancestor lookup: a single AGENT.md entry that exists on the\n * path between a target file or directory and the project root.\n */\nexport interface AncestorAgent {\n    /** Absolute path to the directory containing the AGENT.md */\n    dir: string\n    /** Absolute path to the AGENT.md file */\n    path: string\n    /** Path of the directory relative to the project root */\n    relativeDir: string\n}\n\n/**\n * Return the ordered list of AGENT.md files that exist on the path from a\n * target file or directory up to the project root. The order is root-first,\n * then each intermediate directory, then the target directory itself.\n *\n * Non-existent AGENT.md files are silently skipped (the chain can have gaps).\n *\n * @param target - The absolute or project-relative path to a file or directory.\n * @param projectRoot - The absolute path of the project root (where the root\n *   AGENT.md lives). Defaults to the current working directory.\n *\n * @example\n *   findAncestorAgents('/proj/apps/web/components/ui/button.tsx', '/proj')\n *   // Returns, in order:\n *   // - { dir: '/proj',                path: '/proj/AGENT.md' }\n *   // - { dir: '/proj/apps/web',       path: '/proj/apps/web/AGENT.md' }\n *   // (apps/, components/ skipped because they have no AGENT.md)\n *   // (button.tsx itself is a file, so its parent dir is the last one checked)\n */\nexport function findAncestorAgents(\n    target: string,\n    projectRoot: string = process.cwd()\n): AncestorAgent[] {\n    const absRoot = resolve(projectRoot)\n    const absTarget = resolveAgainstRoot(target, absRoot)\n\n    // Validate that the target lives within the project root\n    const relToRoot = relative(absRoot, absTarget)\n    if (relToRoot.startsWith('..') || isAbsolute(relToRoot)) {\n        throw new Error(\n            `Target \"${target}\" is outside the project root \"${absRoot}\". ` +\n                `findAncestorAgents only handles paths within the project.`\n        )\n    }\n\n    // Collect every directory from the target up to the root, in root-first order.\n    // For a file target, we only look at the directory chain (not the file itself).\n    // For a directory target, the directory itself is included as the last entry.\n    const targetDir = isDirectory(absTarget) ? absTarget : dirname(absTarget)\n    const dirs = collectAncestorDirs(targetDir, absRoot)\n\n    const result: AncestorAgent[] = []\n    for (const dir of dirs) {\n        const agentPath = join(dir, AGENT_FILE)\n        if (existsSync(agentPath)) {\n            result.push({\n                dir,\n                path: agentPath,\n                relativeDir: relativeDir(dir, absRoot),\n            })\n        }\n    }\n\n    return result\n}\n\n/**\n * Resolve a target path against the project root. Accepts absolute paths\n * (returned as-is) and project-relative paths (joined with the root).\n */\nfunction resolveAgainstRoot(target: string, absRoot: string): string {\n    if (isAbsolute(target)) return target\n    return join(absRoot, target)\n}\n\n/**\n * Return the directory chain from a starting directory up to (and including)\n * the project root, in root-first order. The chain is computed by walking\n * the relative path segments from the starting dir back to the root.\n */\nfunction collectAncestorDirs(startDir: string, absRoot: string): string[] {\n    const rel = relative(absRoot, startDir)\n    if (rel === '' || rel === '.') {\n        return [absRoot]\n    }\n\n    const segments = rel.split(sep).filter(s => s !== '' && s !== '.')\n    const chain: string[] = [absRoot]\n    let acc = absRoot\n    for (const seg of segments) {\n        acc = join(acc, seg)\n        chain.push(acc)\n    }\n    return chain\n}\n\n/**\n * Compute the directory's path relative to the project root, in a form\n * suitable for display. The root itself is rendered as \".\".\n */\nfunction relativeDir(dir: string, absRoot: string): string {\n    const rel = relative(absRoot, dir)\n    return rel === '' ? '.' : rel\n}\n\nfunction isDirectory(p: string): boolean {\n    try {\n        return statSync(p).isDirectory()\n    } catch {\n        return false\n    }\n}\n","import yaml from 'js-yaml'\nimport type { AgentContext, AgentSection } from '../types'\n\nexport class AgentParser {\n    /**\n     * Parse an AGENT.md content into a structured AgentContext\n     */\n    static parse(markdown: string): AgentContext {\n        let content = markdown\n        let metadata: Record<string, any> = {}\n\n        // Parse Frontmatter\n        const frontmatterRegex = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/\n        const match = markdown.match(frontmatterRegex)\n        if (match) {\n            try {\n                metadata = yaml.load(match[1] as string) as Record<string, any>\n                content = markdown.slice(match[0].length).trim()\n            } catch (e) {\n                console.error('Failed to parse Agent frontmatter:', e)\n            }\n        }\n\n        const lines = content.split(/\\r?\\n/)\n        const sections: AgentSection[] = []\n        let title = metadata.name ?? 'Unknown Agent'\n        let currentSection: AgentSection | null = null\n        let currentContent: string[] = []\n\n        for (const line of lines) {\n            // Parse Title (Only if not already set by frontmatter)\n            if (line.startsWith('# ') && !metadata.name) {\n                const rawTitle = line.replace('# ', '').trim()\n                // Handle \"AGENT CONTEXT: [Name]\" format\n                if (rawTitle.toUpperCase().startsWith('AGENT CONTEXT:')) {\n                    title = rawTitle\n                        .slice(14)\n                        .replace(/^[:\\s-]+/, '')\n                        .trim()\n                } else {\n                    title = rawTitle\n                }\n                continue\n            }\n\n            // Parse Sections\n            if (line.startsWith('## ')) {\n                // Save previous section\n                if (currentSection) {\n                    currentSection.content = currentContent.join('\\n').trim()\n                    sections.push(currentSection)\n                }\n\n                currentSection = {\n                    title: line.replace('## ', '').trim(),\n                    content: '',\n                }\n                currentContent = []\n                continue\n            }\n\n            // Collect content\n            if (currentSection) {\n                currentContent.push(line)\n            }\n        }\n\n        // Save last section\n        if (currentSection) {\n            currentSection.content = currentContent.join('\\n').trim()\n            sections.push(currentSection)\n        }\n\n        return {\n            title,\n            sections,\n            metadata,\n        }\n    }\n}\n","import { existsSync } from 'node:fs'\nimport { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path'\n\nimport { AUTONOMOS_DIR } from '../constants'\n\n/**\n * Markers that identify the root of an Autonomos / git project.\n *\n * `.autonomos/` is a strong signal: if it exists, the project has already\n * been initialized with the protocol and the directory containing it is,\n * by definition, the project root.\n *\n * `.git/` is a weaker signal: it only tells us the directory is inside a\n * git working tree. We still stop at the first `.git/` we see, which is\n * good enough for the common monorepo case (the monorepo root contains\n * the `.git/`, package subdirectories do not).\n */\nconst PROJECT_MARKERS = [AUTONOMOS_DIR, '.git'] as const\n\n/**\n * Find the directory that owns this project by walking up from `startDir`\n * until we find a directory containing `.autonomos/` or `.git/`.\n *\n * Returns `null` if no such directory exists before we reach the\n * filesystem root.\n *\n * Notes on behavior:\n * - The search stops at the first directory that contains any of the\n *   markers. For monorepos this is the monorepo root, not the package\n *   directory the caller is sitting in.\n * - A directory containing `.git/` is preferred over walking further up:\n *   this prevents leaking into a parent repository in nested-worktree\n *   setups. Callers that need the absolute git toplevel can run\n *   `git rev-parse --show-toplevel` themselves after this returns.\n *\n * @param startDir - Absolute path to start the search from.\n */\nexport function findProjectRoot(startDir: string): string | null {\n    if (!startDir) return null\n    const start = resolve(startDir)\n    let current = start\n\n    while (true) {\n        if (PROJECT_MARKERS.some(marker => existsSync(join(current, marker)))) {\n            return current\n        }\n        const parent = dirname(current)\n        if (parent === current) return null\n        current = parent\n    }\n}\n\n/**\n * Check whether two absolute paths refer to the same directory.\n *\n * Resolves `.` / `..` segments before comparing, so `/a/b` and\n * `/a/b/./` are considered the same.\n */\nexport function isSamePath(a: string, b: string): boolean {\n    if (!a || !b) return false\n    return resolve(a) === resolve(b)\n}\n\n/**\n * Render a path relative to another path, with one guarantee that the\n * default `path.relative` doesn't give us: we never return a value that\n * starts with `..`. If `target` is not under `base`, we return the\n * absolute resolved path of `target` so the caller can still show a\n * useful location.\n */\nexport function displayRelative(target: string, base: string): string {\n    const rel = relative(base, target)\n    if (rel === '' || rel === '.') return '.'\n    if (rel.startsWith(`..${sep}`) || rel === '..' || isAbsolute(rel)) {\n        return resolve(target)\n    }\n    return rel\n}\n","import type { Complexity, Priority, Task, TaskStatus } from '../types'\n\nexport class TaskParser {\n    static parse(markdown: string): Task[] {\n        const tasks: Task[] = []\n        const lines = markdown.split(/\\r?\\n/)\n        const taskRegex = /- \\[([ x/!])\\] \\*\\*\\[(.+)\\]\\*\\* (.+) `Priority: (.+)` `Complexity: (.+)`/\n\n        for (const line of lines) {\n            const match = line.match(taskRegex)\n            if (match) {\n                const [, statusChar = ' ', id = '', title = '', priority = '', complexity = ''] =\n                    match\n                tasks.push({\n                    id,\n                    title: title.trim(),\n                    priority: priority as Priority,\n                    complexity: complexity as Complexity,\n                    status: this.mapStatus(statusChar),\n                })\n            }\n        }\n        return tasks\n    }\n\n    private static mapStatus(char: string): TaskStatus {\n        switch (char) {\n            case ' ':\n                return 'TODO'\n            case '/':\n                return 'IN_PROGRESS'\n            case 'x':\n                return 'DONE'\n            case '!':\n                return 'BLOCKED'\n            default:\n                return 'TODO'\n        }\n    }\n}\n","","import harnessCodesData from './data/harness-codes.json' with { type: 'json' }\nimport {\n    HarnessCodesSchema,\n    type Harness,\n    type HarnessCodes,\n    type Installer,\n} from './schemas/harness-codes'\n\n/**\n * Validated, in-memory representation of the harness codes config.\n * Loaded once at module init, validated via Zod.\n */\nconst codes: HarnessCodes = HarnessCodesSchema.parse(harnessCodesData)\n\n/**\n * Get a single harness entry by its id.\n * Throws if the id is unknown.\n */\nexport function getHarness(id: string): Harness {\n    const entry = codes.platforms[id]\n    if (!entry) {\n        const known = Object.keys(codes.platforms).join(', ')\n        throw new Error(`Unknown harness: \"${id}\". Known harnesses: ${known}`)\n    }\n    return entry\n}\n\n/**\n * List all configured harnesses, as an array of {id, harness} pairs.\n * Stable order: insertion order of the JSON object.\n */\nexport function listHarnesses(): Array<{ id: string; harness: Harness }> {\n    return Object.entries(codes.platforms).map(([id, harness]) => ({ id, harness }))\n}\n\n/**\n * Get the list of preferred harnesses (shown as recommended options).\n */\nexport function listPreferredHarnesses(): Array<{ id: string; harness: Harness }> {\n    return listHarnesses().filter(({ harness }) => harness.preferred)\n}\n\n/**\n * A resolved target directory where workflow files will be written.\n * One per unique path, with the list of harness ids that share it.\n */\nexport interface ResolvedTarget {\n    /** Absolute or project-relative path to the directory */\n    path: string\n    /** File extension to use (e.g. \".md\", \".agent.md\") */\n    fileExtension: string\n    /** Ids of the harnesses that will read from this directory */\n    usedBy: string[]\n}\n\n/**\n * Resolve the unique target directories for a set of harness ids.\n *\n * Harnesses that share the same `skillsDir` (e.g. Codex, OpenCode, KiloCode\n * all use `.agents/skills/`) are deduplicated: the directory appears once\n * in the output, with all the harness ids listed in `usedBy`.\n *\n * The `path` is returned relative to the project root (caller is responsible\n * for joining with the project cwd).\n */\nexport function resolveTargets(harnessIds: string[], cwd: string = '.'): ResolvedTarget[] {\n    const map = new Map<string, ResolvedTarget>()\n\n    for (const id of harnessIds) {\n        const { installer } = getHarness(id)\n        collectFromInstaller(map, installer, id, cwd)\n    }\n\n    return Array.from(map.values())\n}\n\nfunction collectFromInstaller(\n    map: Map<string, ResolvedTarget>,\n    installer: Installer,\n    harnessId: string,\n    cwd: string\n): void {\n    const ext = installer.fileExtension\n    if (installer.workflowsDir) {\n        addTarget(map, joinPath(cwd, installer.workflowsDir), ext, harnessId)\n    } else if (installer.targetDir) {\n        addTarget(map, joinPath(cwd, installer.targetDir), ext, harnessId)\n    } else if (installer.skillsDir) {\n        addTarget(map, joinPath(cwd, installer.skillsDir), ext, harnessId)\n    }\n    if (installer.commandsDir) {\n        addTarget(map, joinPath(cwd, installer.commandsDir), ext, harnessId)\n    }\n}\n\nfunction addTarget(\n    map: Map<string, ResolvedTarget>,\n    path: string,\n    fileExtension: string,\n    harnessId: string\n): void {\n    const existing = map.get(path)\n    if (existing) {\n        if (!existing.usedBy.includes(harnessId)) {\n            existing.usedBy.push(harnessId)\n        }\n    } else {\n        map.set(path, { path, fileExtension, usedBy: [harnessId] })\n    }\n}\n\nfunction joinPath(a: string, b: string): string {\n    if (a === '.' || a === '') return b\n    if (b.startsWith('/')) return `${a}${b}`\n    return `${a}/${b}`\n}\n\n/**\n * Get the raw (validated) codes object, for advanced use cases.\n * Most callers should use the higher-level helpers above.\n */\nexport function getRawHarnessCodes(): HarnessCodes {\n    return codes\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["harnessCodesData"],"sources":["../src/constants.ts","../src/schemas/harness-codes.ts","../src/schemas/manifest.ts","../src/types.ts","../src/templates/agent.ts","../src/templates/manifest.ts","../src/templates/protocol.ts","../src/templates/tasks.ts","../src/templates/worklog.ts","../src/parsers/agent-finder.ts","../src/parsers/agent-parser.ts","../src/parsers/project-root.ts","../src/parsers/task-parser.ts","../src/parsers/task-registry.ts","../src/data/harness-codes.json","../src/harness-codes.ts"],"sourcesContent":["/**\n * Agent Protocol Specification Version (Independent of Package versions)\n * This refers to the schema and behavioral contract version.\n */\nexport const PROTOCOL_VERSION = '0.7.0-alpha'\n\n/**\n * Directory name for Autonomos configuration\n */\nexport const AUTONOMOS_DIR = '.autonomos'\n\n/**\n * Manifest filename\n */\nexport const MANIFEST_FILE = 'manifest.json'\n\n/**\n * Protocol filename\n */\nexport const PROTOCOL_FILE = 'PROTOCOL.md'\n\n/**\n * Tasks filename\n */\nexport const TASKS_FILE = 'TASKS.md'\n\n/**\n * Agent context filename (at project root)\n */\nexport const AGENT_FILE = 'AGENT.md'\n\n/**\n * Worklogs directory name\n */\nexport const WORKLOGS_DIR = 'worklogs'\n\n/**\n * Optional project-owned directory for durable target-state specifications\n */\nexport const SPECS_DIR = 'specs'\n\n/**\n * Optional project-owned directory for technical decision records (ADRs)\n */\nexport const DECISIONS_DIR = 'decisions'\n\n/** Optional project-owned history, never loaded by default. */\nexport const ARCHIVE_DIR = 'archive'\n","import { z } from 'zod'\n\n/**\n * Installer configuration for a single harness.\n *\n * At least one of `workflowsDir`, `targetDir`, or `skillsDir` must be defined.\n *\n * - `workflowsDir`: Where the protocol workflow files are written.\n *    Preferred field — used by most harnesses.\n * - `targetDir`: Single directory (legacy, like Cline's .clinerules/workflows/).\n * - `skillsDir`: Skills directory (legacy, for harnesses that don't distinguish\n *    skills from workflows).\n * - `commandsDir`: Additional commands directory (optional).\n */\nexport const InstallerSchema = z\n    .object({\n        workflowsDir: z.string().optional(),\n        targetDir: z.string().optional(),\n        skillsDir: z.string().optional(),\n        commandsDir: z.string().optional(),\n        globalTargetDir: z.string().optional(),\n        fileExtension: z.string(),\n    })\n    .refine(\n        data => Boolean(data.workflowsDir) || Boolean(data.targetDir) || Boolean(data.skillsDir),\n        {\n            message: 'At least one of `workflowsDir`, `targetDir`, or `skillsDir` must be defined',\n        }\n    )\n\n/**\n * A single harness entry.\n */\nexport const HarnessSchema = z.object({\n    name: z.string().min(1),\n    preferred: z.boolean(),\n    installer: InstallerSchema,\n})\n\n/**\n * Root schema for the harness-codes configuration file.\n */\nexport const HarnessCodesSchema = z.object({\n    platforms: z.record(z.string(), HarnessSchema),\n})\n\nexport type Installer = z.infer<typeof InstallerSchema>\nexport type Harness = z.infer<typeof HarnessSchema>\nexport type HarnessCodes = z.infer<typeof HarnessCodesSchema>\n","import { z } from 'zod'\n\n/**\n * Manifest Schema for .autonomos/manifest.json\n */\nexport const ManifestSchema = z.object({\n    protocolVersion: z.string().describe('Version of the Agent Protocol specification'),\n    cliVersion: z.string().describe('Version of the CLI that last updated this project'),\n    initializedAt: z.string().datetime().describe('ISO timestamp of project initialization'),\n    lastUpdated: z.string().datetime().describe('ISO timestamp of last protocol update'),\n})\n\nexport type Manifest = z.infer<typeof ManifestSchema>\n","/**\n * Priority levels for tasks\n */\nexport type Priority = '🔴 Critical' | '🟠 High' | '🔵 Medium' | '⚪ Low'\n\n/**\n * Complexity estimates for tasks\n */\nexport type Complexity = 'S' | 'M' | 'L' | 'XL'\n\n/**\n * Task status markers\n */\nexport type TaskStatus = 'TODO' | 'IN_PROGRESS' | 'DONE' | 'BLOCKED'\n\n/**\n * Task entity parsed from TASKS.md\n */\nexport interface Task {\n    id: string\n    title: string\n    priority: Priority\n    complexity: Complexity\n    status: TaskStatus\n    worklogPath?: string\n}\n\n/**\n * Agent configuration parsed from AGENT.md\n */\nexport interface AgentConfig {\n    name: string\n    description?: string\n    stack: string[]\n    preferences?: Record<string, any>\n}\n\nexport interface AgentSection {\n    title: string\n    content: string\n}\n\nexport interface AgentContext {\n    title: string\n    description?: string\n    sections: AgentSection[]\n    metadata?: Record<string, any>\n}\n\nexport const PRIORITIES: Priority[] = ['🔴 Critical', '🟠 High', '🔵 Medium', '⚪ Low']\nexport const COMPLEXITIES: Complexity[] = ['S', 'M', 'L', 'XL']\n","/**\n * Template for AGENT.md - The context anchor at project root\n * @param projectName - Name of the project to personalize the template\n */\nexport function generateAgentTemplate(projectName: string = 'Project'): string {\n    return `---\nname: \"${projectName}\"\ntype: \"project\"\nstatus: \"active\"\n---\n# AGENT CONTEXT: ${projectName}\n\n## 🧠 Context & Objectives\n\n*Describe what this project does and its main goals.*\n\n## ⚙️ Workflow & Preferences\n\n- **Commits:** Conventional Commits\n- **Language:** English\n- **Design:** If present, read root \\`DESIGN.md\\` before changing a user-facing surface; use \\`/design\\` for new direction, critique, or design-knowledge extraction.\n\n## 🏗 Stack & Architecture\n\n- **Tech:** *(List frameworks, libraries)*\n- **Patterns:** *(Architecture patterns used)*\n\n## 📁 Key Directories\n\n| Path | Description |\n|------|-------------|\n| \\`src/\\` | Source code |\n| \\`.autonomos/\\` | Agent Protocol files |\n\n## ⚠️ Known Constraints\n\n*List any technical debts, missing features, or external limitations.*\n`\n}\n\n/**\n * Generate a minimal local AGENT.md for subdirectories.\n * Free format by design — low friction encourages creation.\n * @param dirName - Name of the directory\n */\nexport function generateLocalAgentTemplate(dirName: string): string {\n    return `# AGENT: ${dirName}\n\n- **Stack:** *(frameworks, libs specific to this module)*\n- **Conventions:** *(naming, exports, test patterns)*\n- **Constraints:** *(known issues, tech debt)*\n`\n}\n\n/**\n * Default root AGENT.md template\n */\nexport const AGENT_TEMPLATE = generateAgentTemplate()\n\n/**\n * Default local AGENT.md template\n */\nexport const LOCAL_AGENT_TEMPLATE = generateLocalAgentTemplate('module')\n","import { PROTOCOL_VERSION } from '../constants'\nimport { ManifestSchema, type Manifest } from '../schemas/manifest'\n\n/**\n * Creates a new manifest object with current timestamps\n */\nexport function createManifest(cliVersion: string): Manifest {\n    const now = new Date().toISOString()\n    return {\n        protocolVersion: PROTOCOL_VERSION,\n        cliVersion,\n        initializedAt: now,\n        lastUpdated: now,\n    }\n}\n\n/**\n * Generates the manifest.json content as a formatted string\n */\nexport function generateManifestContent(manifest: Manifest): string {\n    return JSON.stringify(manifest, null, 4) + '\\n'\n}\n\n/**\n * Parses manifest.json content into a Manifest object with validation\n */\nexport function parseManifest(content: string): Manifest {\n    const data = JSON.parse(content)\n    return ManifestSchema.parse(data)\n}\n","import { PROTOCOL_VERSION } from '../constants'\n\n/**\n * The Protocol kernel template — v0.7\n *\n * Design principles (v0.7):\n * - PROTOCOL.md is a compact REFERENCE, not an executable workflow.\n * - All step-by-step instructions live in the workflow files.\n * - No duplication between PROTOCOL.md and workflows.\n * - Short enough that an LLM can re-scan it mid-session without cost.\n */\nexport const PROTOCOL_TEMPLATE = `# AUTONOMOS PROTOCOL (v${PROTOCOL_VERSION})\n\n> This file defines the project's AI workflow contract. The workflows execute it. Do not duplicate workflow steps here.\n\n## Quick Reference\n\n| Action                           | How                                                                                |\n| -------------------------------- | ---------------------------------------------------------------------------------- |\n| Start a session                  | Read the \\`/session\\` workflow                                                       |\n| Start a task                     | Read the \\`/task\\` workflow                                                          |\n| Triage a problem or proposal     | Read the optional \\`/issue\\` workflow                                                |\n| Adopt existing project knowledge | Read the optional \\`/adopt\\` workflow                                                |\n| Reconcile drift and archive history          | Read the \\`/reconcile\\` workflow                                                     |\n| Design or critique a surface     | Read the optional \\`/design\\` workflow                                               |\n| End a session                    | Read the \\`/crystallize\\` workflow                                                   |\n| Get context                      | Read root \\`AGENT.md\\`, then only the selected scope's ancestor chain                |\n| Resolve objective                | Explicit user request first; otherwise resume \\`[/]\\` or pick highest-priority \\`[ ]\\` |\n| Log session work                 | Create \\`.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md\\`                               |\n\n## File Map\n\n| File            | Location                   | Role                                              |\n| --------------- | -------------------------- | ------------------------------------------------- |\n| \\`AGENT.md\\`      | Root + any subdirectory    | Durable guidance for its directory scope          |\n| \\`TASKS.md\\`      | \\`.autonomos/TASKS.md\\`      | Current task state and optional Current direction             |\n| \\`ISSUES.md\\`     | \\`.autonomos/ISSUES.md\\`     | Optional problem, proposal, and question intake   |\n| \\`worklogs/\\`     | \\`.autonomos/worklogs/\\`     | Historical session evidence, not current guidance |\n| \\`archive/\\`     | \\`.autonomos/archive/\\`     | Optional history, searched only when justified     |\n| \\`specs/\\`        | \\`.autonomos/specs/\\`        | Optional project-owned normative target state     |\n| \\`decisions/\\`    | \\`.autonomos/decisions/\\`    | Optional project-owned decision records (ADRs)    |\n| \\`DESIGN.md\\`     | Root or target scope      | Optional project-owned visual/interaction direction |\n| \\`PROTOCOL.md\\`   | \\`.autonomos/PROTOCOL.md\\`   | This file — read-only reference                   |\n| \\`manifest.json\\` | \\`.autonomos/manifest.json\\` | Protocol version metadata                         |\n\n## Design Direction Boundary\n\n\\`DESIGN.md\\` is optional project-owned direction, not a managed protocol\nartifact. Use \\`/design\\` when a surface needs direction, critique, or\ndesign-knowledge extraction; keep the project's identity and examples local.\nThe workflow supplies routing and evidence rules, not a universal visual style.\n\n## AGENT.md Format Rules\n\nStore only stable guidance that will affect different future tasks. Keep transient evidence in worklogs and operational explanations in component documentation. Use the narrowest applicable \\`AGENT.md\\`; consolidate or replace obsolete entries instead of appending history. Preserve valid subclaims in mixed paragraphs. Check the resulting text for completed-action narratives, task progress and unsupported prohibitions; these do not belong in operating guidance.\n\n**Root \\`AGENT.md\\`** — Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).\n\n**Local \\`AGENT.md\\`** (in any subdirectory) — Free format. One line is enough if it is clear. What matters: the next session can use it. Example:\n\n\\`\\`\\`markdown\n# AGENT: packages/core\n\n- Stack: TypeScript, Vitest, tsdown\n- Conventions: exports via src/index.ts, tests co-located (\\\\*.test.ts)\n- Constraint: template changes require workflow test updates\n\\`\\`\\`\n\n## Issue, Specification, Decision, and Task Rules\n\nIssues describe evidence, impact, and a desired outcome without choosing implementation; proposed directions remain hypotheses until an approach is accepted. Specifications describe accepted target behavior or requirements that may guide multiple tasks. A decision record (commonly ADR, Architecture Decision Record) captures one technical choice and its rationale. Tasks describe an accepted intervention and completion criteria. Use optional \\`ISSUES.md\\`, \\`specs/\\`, and \\`decisions/\\` only when they provide value; direct, clear changes may become tasks immediately. Link related issues, specs, decisions, and tasks in both directions.\n\n## Specification and Decision Rules\n\n- \\`.autonomos/specs/\\` and \\`.autonomos/decisions/\\` are optional, project-owned, first-use directories; \\`init\\`, \\`update\\`, and artifact-integrity checks do not create or overwrite them.\n- Keep one Markdown file per bounded specification or decision. Include status, scope, provenance, acceptance criteria or consequences, and replacement links where relevant; no parser or independent version is required initially.\n- Specification status is \\`draft\\`, \\`accepted\\`, or \\`superseded\\`. Only \\`accepted\\` is normative; \\`superseded\\` points to its successor. Acceptance does not mean implementation is complete.\n- Decision records use \\`proposed\\`, \\`accepted\\`, or \\`superseded\\`; they preserve rationale and alternatives rather than duplicating the full specification.\n- Keep stable agent operating rules in \\`AGENT.md\\`, user/developer reference in \\`docs/\\`, execution state in \\`TASKS.md\\`, and historical evidence in \\`worklogs/\\`.\n- Read only relevant accepted records at task start. Use \\`/adopt\\` to extract legacy knowledge; never rewrite historical worklogs, issues, or tasks to create current artifacts.\n\nThe protocol-facing name is **decision record**. **ADR** (Architecture Decision Record) is a common convention for the same kind of document, not a required external standard. Use these lightweight Markdown shapes as a starting point; they are conventions, not parser-enforced schemas:\n\n\\`\\`\\`markdown\n# SPEC-001 — Concise target-state title\n\n- Status: draft | accepted | superseded\n- Scope: component, capability, or boundary\n- Provenance: issue, discussion, or source links\n- Related decisions: ADR-001, ...\n- Superseded by: SPEC-002 (when applicable)\n\n## Intent\n\n## Requirements\n\n## Acceptance criteria\n\n## Out of scope\n\\`\\`\\`\n\n\\`\\`\\`markdown\n# ADR-001 — Concise decision title\n\n- Status: proposed | accepted | superseded\n- Scope: component or technical boundary\n- Provenance: issue, task, or investigation links\n- Related specs: SPEC-001, ...\n- Superseded by: ADR-002 (when applicable)\n\n## Context\n\n## Decision\n\n## Alternatives considered\n\n## Consequences\n\\`\\`\\`\n\nOnly user/project governance accepts a specification or decision as normative. Agents may draft and link records, but must not silently promote them; acceptance is separate from implementation completion.\n\n## Current Context and Archival Lifecycle\n\n- Current context must support ordinary work without archives. Keep applicable guidance, accepted requirements/decisions, unresolved work, dependencies and necessary next actions discoverable. Acceptance is independent of implementation; dated temporary directives remain active until lifted or their stated end condition is met.\n- A completed task or resolved/declined issue is an archival candidate only when its own scope is settled and still-needed outcomes/constraints/references are retained in current context. Explicitly abandoned work may be archived with its reason, without claiming it was completed. A completed child does not satisfy unmet parent acceptance criteria.\n- Record new task completion dates as \\`Completed: YYYY-MM-DD\\`; do not infer missing old dates from worklog filenames. Age, a checkbox, absent code or a newer statement alone is not proof of obsolescence.\n- Group archival at coherent completed-work boundaries, not per task or calendar interval. No Sprint object or scheduled maintenance is required. Correct certain in-scope drift proactively during normal work; use \\`/reconcile\\` for investigation, consolidation and archival.\n- Before moving history, consolidate current knowledge in its existing narrowest home. Optional \\`Current direction\\` in \\`TASKS.md\\` explains present aims, recent consequential outcomes and next work; rewrite it rather than append chronology. Keep progress out of \\`AGENT.md\\`.\n- Create project-owned \\`.autonomos/archive/README.md\\` and meaningful batch directories on first use only. A batch can contain \\`TASKS.md\\`, \\`ISSUES.md\\`, \\`worklogs/\\` and provenance for retired guidance. Group/split batches by useful scope; there is no fixed age, size or mandatory per-record schema.\n- Archive means move, not delete or rewrite conclusions. Preserve historical record content, identifiers and provenance; repair relative paths when necessary. Preserve original mixed-source text when retiring only some claims. Applicable specs/decisions stay current independently of execution records. Extraction into new normative artifacts still uses \\`/adopt\\`.\n- The archive index maps batch topics to records, not a second task journal. Search by ID or subject only when a specific question requires history; neither archives nor their entire index are routine startup context. Keep only necessary dependency/outcome pointers in current records, not a permanent stub for every completed task.\n- Archived task and issue IDs remain reserved. Before assigning an ID, search current and archived registries. With a CLI, \\`readTaskRegistry(root, { history: true })\\` exposes task references and duplicates; plain Markdown search works without it.\n- Verify exact source text before edits, retained current knowledge, IDs and resolvable references after moves. Do not confuse tool annotations with file content or historical validation with a current observation. Re-read shared files before writing and preserve unrelated concurrent changes. Stop when a second pass yields no deterministic correction.\n- \\`autonomos status\\` summarizes the current task registry; \\`--history\\` adds separate archived counts and read/collision diagnostics. Archived means historical, not necessarily completed. History uses batch \\`TASKS.md\\` files, not arbitrary worklog checklists.\n- Archives are project-owned, like specs and decisions. Initialization, updates and integrity checks neither create empty archives nor overwrite, relocate or judge their contents. Installing a new protocol performs no automatic cleanup. Version-control policy stays project-owned; Git is not required for archival or retrieval.\n\nExample (only files needed by a batch are created):\n\n\\`\\`\\`text\n.autonomos/\n  TASKS.md\n  ISSUES.md\n  archive/\n    README.md\n    realtime-experiment-retirement/\n      TASKS.md\n      ISSUES.md\n      worklogs/\n\\`\\`\\`\n\n## Task Format\n\n\\`- [Status] **[ID]** Title \\\\\\`Priority\\\\\\` \\\\\\`Complexity\\\\\\`\\`\n\n| Status            | Priority      | Complexity |\n| ----------------- | ------------- | ---------- |\n| \\`[ ]\\` Todo        | \\`🔴 Critical\\` | \\`S\\` Small  |\n| \\`[/]\\` In Progress | \\`🟠 High\\`     | \\`M\\` Medium |\n| \\`[x]\\` Done        | \\`🔵 Medium\\`   | \\`L\\` Large  |\n| \\`[!]\\` Blocked     | \\`⚪ Low\\`      | \\`XL\\` Huge  |\n\n## Metadata Rules\n\n- **Language:** English unless AGENT.md says otherwise.\n- **Tone:** Technical, concise, fact-based.\n- **Continuity:** Refer to previous work as \"we\" or \"the project\".\n`\n\n/**\n * @deprecated Use PROTOCOL_TEMPLATE instead\n */\nexport const PROTOCOL_TEMPLATE_V2026_1 = PROTOCOL_TEMPLATE\n","/**\n * Template for TASKS.md - The task registry\n */\nexport const TASKS_TEMPLATE = `# PROJECT TASKS & ROADMAP\n\n> **LEGEND**\n> **Priority:** [🔴 Critical] [🟠 High] [🔵 Medium] [⚪ Low]\n> **Complexity:** [S] Small, [M] Medium, [L] Large, [XL] Huge (Planning required)\n> **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked\n\n## 🚀 Current work\n\n- [ ] **[INIT-01]** Review project context and structure \\`Priority: 🔵\\` \\`Complexity: S\\`\n\n## 🔮 Backlog\n\n*(Add future tasks here)*\n`\n","import type { TaskStatus } from '../types'\n\ninterface WorklogOptions {\n    taskId: string\n    taskName: string\n    date?: string\n    status: 'Complete' | 'Partial' | 'Blocked'\n    description: string\n    filesModified: string[]\n    decisions: string[]\n    challenges: string[]\n    nextSteps: string[]\n}\n\n/**\n * Generate a Worklog markdown content\n */\nexport function generateWorklogContent(options: WorklogOptions): string {\n    const date = options.date ?? new Date().toISOString().split('T')[0]\n\n    return `# WORKLOG: [${options.taskId}] ${options.taskName}\n**Date:** ${date}\n**Agent Status:** [${options.status}]\n\n## 📝 Description\n${options.description}\n\n## 🛠 Technical Details\n- **Files Modified:**\n${options.filesModified.map(f => `  - ${f}`).join('\\n')}\n- **Key Decisions:**\n${options.decisions.map(d => `  - ${d}`).join('\\n')}\n- **Challenges:**\n${options.challenges.map(c => `  - ${c}`).join('\\n')}\n\n## ⏭ Next Steps / Context for Successor\n${options.nextSteps.map(s => `- ${s}`).join('\\n')}\n`\n}\n\n/**\n * Common status mapping for worklogs\n */\nexport function mapTaskStatusToWorklogStatus(\n    status: TaskStatus\n): 'Complete' | 'Partial' | 'Blocked' {\n    switch (status) {\n        case 'DONE':\n            return 'Complete'\n        case 'BLOCKED':\n            return 'Blocked'\n        default:\n            return 'Partial'\n    }\n}\n","import { existsSync, statSync } from 'node:fs'\nimport { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path'\n\nimport { AGENT_FILE } from '../constants'\n\n/**\n * Result of an ancestor lookup: a single AGENT.md entry that exists on the\n * path between a target file or directory and the project root.\n */\nexport interface AncestorAgent {\n    /** Absolute path to the directory containing the AGENT.md */\n    dir: string\n    /** Absolute path to the AGENT.md file */\n    path: string\n    /** Path of the directory relative to the project root */\n    relativeDir: string\n}\n\n/**\n * Return the ordered list of AGENT.md files that exist on the path from a\n * target file or directory up to the project root. The order is root-first,\n * then each intermediate directory, then the target directory itself.\n *\n * Non-existent AGENT.md files are silently skipped (the chain can have gaps).\n *\n * @param target - The absolute or project-relative path to a file or directory.\n * @param projectRoot - The absolute path of the project root (where the root\n *   AGENT.md lives). Defaults to the current working directory.\n *\n * @example\n *   findAncestorAgents('/proj/apps/web/components/ui/button.tsx', '/proj')\n *   // Returns, in order:\n *   // - { dir: '/proj',                path: '/proj/AGENT.md' }\n *   // - { dir: '/proj/apps/web',       path: '/proj/apps/web/AGENT.md' }\n *   // (apps/, components/ skipped because they have no AGENT.md)\n *   // (button.tsx itself is a file, so its parent dir is the last one checked)\n */\nexport function findAncestorAgents(\n    target: string,\n    projectRoot: string = process.cwd()\n): AncestorAgent[] {\n    const absRoot = resolve(projectRoot)\n    const absTarget = resolveAgainstRoot(target, absRoot)\n\n    // Validate that the target lives within the project root\n    const relToRoot = relative(absRoot, absTarget)\n    if (relToRoot.startsWith('..') || isAbsolute(relToRoot)) {\n        throw new Error(\n            `Target \"${target}\" is outside the project root \"${absRoot}\". ` +\n                `findAncestorAgents only handles paths within the project.`\n        )\n    }\n\n    // Collect every directory from the target up to the root, in root-first order.\n    // For a file target, we only look at the directory chain (not the file itself).\n    // For a directory target, the directory itself is included as the last entry.\n    const targetDir = isDirectory(absTarget) ? absTarget : dirname(absTarget)\n    const dirs = collectAncestorDirs(targetDir, absRoot)\n\n    const result: AncestorAgent[] = []\n    for (const dir of dirs) {\n        const agentPath = join(dir, AGENT_FILE)\n        if (existsSync(agentPath)) {\n            result.push({\n                dir,\n                path: agentPath,\n                relativeDir: relativeDir(dir, absRoot),\n            })\n        }\n    }\n\n    return result\n}\n\n/**\n * Resolve a target path against the project root. Accepts absolute paths\n * (returned as-is) and project-relative paths (joined with the root).\n */\nfunction resolveAgainstRoot(target: string, absRoot: string): string {\n    if (isAbsolute(target)) return target\n    return join(absRoot, target)\n}\n\n/**\n * Return the directory chain from a starting directory up to (and including)\n * the project root, in root-first order. The chain is computed by walking\n * the relative path segments from the starting dir back to the root.\n */\nfunction collectAncestorDirs(startDir: string, absRoot: string): string[] {\n    const rel = relative(absRoot, startDir)\n    if (rel === '' || rel === '.') {\n        return [absRoot]\n    }\n\n    const segments = rel.split(sep).filter(s => s !== '' && s !== '.')\n    const chain: string[] = [absRoot]\n    let acc = absRoot\n    for (const seg of segments) {\n        acc = join(acc, seg)\n        chain.push(acc)\n    }\n    return chain\n}\n\n/**\n * Compute the directory's path relative to the project root, in a form\n * suitable for display. The root itself is rendered as \".\".\n */\nfunction relativeDir(dir: string, absRoot: string): string {\n    const rel = relative(absRoot, dir)\n    return rel === '' ? '.' : rel\n}\n\nfunction isDirectory(p: string): boolean {\n    try {\n        return statSync(p).isDirectory()\n    } catch {\n        return false\n    }\n}\n","import yaml from 'js-yaml'\nimport type { AgentContext, AgentSection } from '../types'\n\nexport class AgentParser {\n    /**\n     * Parse an AGENT.md content into a structured AgentContext\n     */\n    static parse(markdown: string): AgentContext {\n        let content = markdown\n        let metadata: Record<string, any> = {}\n\n        // Parse Frontmatter\n        const frontmatterRegex = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/\n        const match = markdown.match(frontmatterRegex)\n        if (match) {\n            try {\n                metadata = yaml.load(match[1] as string) as Record<string, any>\n                content = markdown.slice(match[0].length).trim()\n            } catch (e) {\n                console.error('Failed to parse Agent frontmatter:', e)\n            }\n        }\n\n        const lines = content.split(/\\r?\\n/)\n        const sections: AgentSection[] = []\n        let title = metadata.name ?? 'Unknown Agent'\n        let currentSection: AgentSection | null = null\n        let currentContent: string[] = []\n\n        for (const line of lines) {\n            // Parse Title (Only if not already set by frontmatter)\n            if (line.startsWith('# ') && !metadata.name) {\n                const rawTitle = line.replace('# ', '').trim()\n                // Handle \"AGENT CONTEXT: [Name]\" format\n                if (rawTitle.toUpperCase().startsWith('AGENT CONTEXT:')) {\n                    title = rawTitle\n                        .slice(14)\n                        .replace(/^[:\\s-]+/, '')\n                        .trim()\n                } else {\n                    title = rawTitle\n                }\n                continue\n            }\n\n            // Parse Sections\n            if (line.startsWith('## ')) {\n                // Save previous section\n                if (currentSection) {\n                    currentSection.content = currentContent.join('\\n').trim()\n                    sections.push(currentSection)\n                }\n\n                currentSection = {\n                    title: line.replace('## ', '').trim(),\n                    content: '',\n                }\n                currentContent = []\n                continue\n            }\n\n            // Collect content\n            if (currentSection) {\n                currentContent.push(line)\n            }\n        }\n\n        // Save last section\n        if (currentSection) {\n            currentSection.content = currentContent.join('\\n').trim()\n            sections.push(currentSection)\n        }\n\n        return {\n            title,\n            sections,\n            metadata,\n        }\n    }\n}\n","import { existsSync } from 'node:fs'\nimport { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path'\n\nimport { AUTONOMOS_DIR } from '../constants'\n\n/**\n * Markers that identify the root of an Autonomos / git project.\n *\n * `.autonomos/` is a strong signal: if it exists, the project has already\n * been initialized with the protocol and the directory containing it is,\n * by definition, the project root.\n *\n * `.git/` is a weaker signal: it only tells us the directory is inside a\n * git working tree. We still stop at the first `.git/` we see, which is\n * good enough for the common monorepo case (the monorepo root contains\n * the `.git/`, package subdirectories do not).\n */\nconst PROJECT_MARKERS = [AUTONOMOS_DIR, '.git'] as const\n\n/**\n * Find the directory that owns this project by walking up from `startDir`\n * until we find a directory containing `.autonomos/` or `.git/`.\n *\n * Returns `null` if no such directory exists before we reach the\n * filesystem root.\n *\n * Notes on behavior:\n * - The search stops at the first directory that contains any of the\n *   markers. For monorepos this is the monorepo root, not the package\n *   directory the caller is sitting in.\n * - A directory containing `.git/` is preferred over walking further up:\n *   this prevents leaking into a parent repository in nested-worktree\n *   setups. Callers that need the absolute git toplevel can run\n *   `git rev-parse --show-toplevel` themselves after this returns.\n *\n * @param startDir - Absolute path to start the search from.\n */\nexport function findProjectRoot(startDir: string): string | null {\n    if (!startDir) return null\n    const start = resolve(startDir)\n    let current = start\n\n    while (true) {\n        if (PROJECT_MARKERS.some(marker => existsSync(join(current, marker)))) {\n            return current\n        }\n        const parent = dirname(current)\n        if (parent === current) return null\n        current = parent\n    }\n}\n\n/**\n * Check whether two absolute paths refer to the same directory.\n *\n * Resolves `.` / `..` segments before comparing, so `/a/b` and\n * `/a/b/./` are considered the same.\n */\nexport function isSamePath(a: string, b: string): boolean {\n    if (!a || !b) return false\n    return resolve(a) === resolve(b)\n}\n\n/**\n * Render a path relative to another path, with one guarantee that the\n * default `path.relative` doesn't give us: we never return a value that\n * starts with `..`. If `target` is not under `base`, we return the\n * absolute resolved path of `target` so the caller can still show a\n * useful location.\n */\nexport function displayRelative(target: string, base: string): string {\n    const rel = relative(base, target)\n    if (rel === '' || rel === '.') return '.'\n    if (rel.startsWith(`..${sep}`) || rel === '..' || isAbsolute(rel)) {\n        return resolve(target)\n    }\n    return rel\n}\n","import type { Complexity, Priority, Task, TaskStatus } from '../types'\n\nexport class TaskParser {\n    /** Discover IDs/status without requiring optional priority or complexity metadata. */\n    static references(markdown: string): { id: string; status: TaskStatus; line: number }[] {\n        const references: { id: string; status: TaskStatus; line: number }[] = []\n        let fence: string | undefined\n        for (const [index, line] of markdown.split(/\\r?\\n/).entries()) {\n            const marker = line.match(/^\\s{0,3}(`{3,}|~{3,})/)\n            if (marker?.[1]) {\n                if (!fence) fence = marker[1]\n                else if (\n                    marker[1][0] === fence[0] &&\n                    marker[1].length >= fence.length &&\n                    !line.slice(marker[0].length).trim()\n                )\n                    fence = undefined\n                continue\n            }\n            if (fence) continue\n            const match = line.match(/^\\s*- \\[([ x/!])\\] \\*\\*\\[([^\\]]+)\\]\\*\\*/)\n            if (match?.[1] && match[2]?.trim()) {\n                references.push({\n                    id: match[2].trim(),\n                    status: this.mapStatus(match[1]),\n                    line: index + 1,\n                })\n            }\n        }\n        return references\n    }\n\n    static parse(markdown: string): Task[] {\n        const tasks: Task[] = []\n        const lines = markdown.split(/\\r?\\n/)\n        const taskRegex = /- \\[([ x/!])\\] \\*\\*\\[(.+)\\]\\*\\* (.+) `Priority: (.+)` `Complexity: (.+)`/\n\n        for (const line of lines) {\n            const match = line.match(taskRegex)\n            if (match) {\n                const [, statusChar = ' ', id = '', title = '', priority = '', complexity = ''] =\n                    match\n                tasks.push({\n                    id,\n                    title: title.trim(),\n                    priority: priority as Priority,\n                    complexity: complexity as Complexity,\n                    status: this.mapStatus(statusChar),\n                })\n            }\n        }\n        return tasks\n    }\n\n    private static mapStatus(char: string): TaskStatus {\n        switch (char) {\n            case ' ':\n                return 'TODO'\n            case '/':\n                return 'IN_PROGRESS'\n            case 'x':\n                return 'DONE'\n            case '!':\n                return 'BLOCKED'\n            default:\n                return 'TODO'\n        }\n    }\n}\n","import { lstatSync, readFileSync, readdirSync } from 'node:fs'\nimport { join, relative } from 'node:path'\n\nimport { ARCHIVE_DIR, AUTONOMOS_DIR, TASKS_FILE } from '../constants'\nimport { TaskParser } from './task-parser'\n\nexport interface TaskReference {\n    id: string\n    status: ReturnType<typeof TaskParser.references>[number]['status']\n    line: number\n    /** Source path relative to the supplied project root. */\n    path: string\n}\n\nexport interface TaskRegistry {\n    current: TaskReference[]\n    archived: TaskReference[]\n    duplicateIds: string[]\n    warnings: string[]\n    /** False if a requested registry could not be inspected completely. */\n    complete: boolean\n}\n\n/** Read current task IDs; opt into history for reporting or reserving a new ID. */\nexport function readTaskRegistry(root: string, options: { history?: boolean } = {}): TaskRegistry {\n    const registry: TaskRegistry = {\n        current: [],\n        archived: [],\n        duplicateIds: [],\n        warnings: [],\n        complete: true,\n    }\n    function warn(path: string, message: string): void {\n        registry.complete = false\n        registry.warnings.push(`${relative(root, path)}: ${message}`)\n    }\n    function read(path: string, target: TaskReference[]): void {\n        try {\n            const stat = lstatSync(path)\n            if (!stat.isFile()) {\n                warn(path, 'Expected a regular task registry; symbolic links are not followed')\n                return\n            }\n            target.push(\n                ...TaskParser.references(readFileSync(path, 'utf8')).map(task => ({\n                    ...task,\n                    path: relative(root, path),\n                }))\n            )\n        } catch (error) {\n            warn(path, error instanceof Error ? error.message : String(error))\n        }\n    }\n    function scan(path: string, optional = false): void {\n        try {\n            const stat = lstatSync(path)\n            if (!stat.isDirectory()) {\n                warn(path, 'Expected an archive directory; symbolic links are not followed')\n                return\n            }\n            for (const entry of readdirSync(path, { withFileTypes: true }).sort((a, b) =>\n                a.name.localeCompare(b.name)\n            )) {\n                const child = join(path, entry.name)\n                if (entry.isSymbolicLink()) warn(child, 'Skipped symbolic link in archive')\n                else if (entry.isDirectory()) scan(child)\n                else if (entry.name === TASKS_FILE) read(child, registry.archived)\n            }\n        } catch (error) {\n            if (optional && (error as NodeJS.ErrnoException).code === 'ENOENT') return\n            warn(path, error instanceof Error ? error.message : String(error))\n        }\n    }\n    const autonomosPath = join(root, AUTONOMOS_DIR)\n    try {\n        if (!lstatSync(autonomosPath).isDirectory()) {\n            warn(\n                autonomosPath,\n                'Expected a regular project directory; symbolic links are not followed'\n            )\n            return registry\n        }\n    } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n            warn(autonomosPath, error instanceof Error ? error.message : String(error))\n        }\n        return registry\n    }\n    const currentPath = join(autonomosPath, TASKS_FILE)\n    try {\n        lstatSync(currentPath)\n        read(currentPath, registry.current)\n    } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n            warn(currentPath, error instanceof Error ? error.message : String(error))\n        }\n    }\n    if (options.history) scan(join(root, AUTONOMOS_DIR, ARCHIVE_DIR), true)\n    const seen = new Set<string>()\n    const duplicates = new Set<string>()\n    for (const task of [...registry.current, ...registry.archived]) {\n        if (seen.has(task.id)) duplicates.add(task.id)\n        seen.add(task.id)\n    }\n    registry.duplicateIds = [...duplicates].sort()\n    return registry\n}\n","","import harnessCodesData from './data/harness-codes.json' with { type: 'json' }\nimport {\n    HarnessCodesSchema,\n    type Harness,\n    type HarnessCodes,\n    type Installer,\n} from './schemas/harness-codes'\n\n/**\n * Validated, in-memory representation of the harness codes config.\n * Loaded once at module init, validated via Zod.\n */\nconst codes: HarnessCodes = HarnessCodesSchema.parse(harnessCodesData)\n\n/**\n * Get a single harness entry by its id.\n * Throws if the id is unknown.\n */\nexport function getHarness(id: string): Harness {\n    const entry = codes.platforms[id]\n    if (!entry) {\n        const known = Object.keys(codes.platforms).join(', ')\n        throw new Error(`Unknown harness: \"${id}\". Known harnesses: ${known}`)\n    }\n    return entry\n}\n\n/**\n * List all configured harnesses, as an array of {id, harness} pairs.\n * Stable order: insertion order of the JSON object.\n */\nexport function listHarnesses(): Array<{ id: string; harness: Harness }> {\n    return Object.entries(codes.platforms).map(([id, harness]) => ({ id, harness }))\n}\n\n/**\n * Get the list of preferred harnesses (shown as recommended options).\n */\nexport function listPreferredHarnesses(): Array<{ id: string; harness: Harness }> {\n    return listHarnesses().filter(({ harness }) => harness.preferred)\n}\n\n/**\n * A resolved target directory where workflow files will be written.\n * One per unique path, with the list of harness ids that share it.\n */\nexport interface ResolvedTarget {\n    /** Absolute or project-relative path to the directory */\n    path: string\n    /** File extension to use (e.g. \".md\", \".agent.md\") */\n    fileExtension: string\n    /** Ids of the harnesses that will read from this directory */\n    usedBy: string[]\n}\n\n/**\n * Resolve the unique target directories for a set of harness ids.\n *\n * Harnesses that share the same `skillsDir` (e.g. Codex, OpenCode, KiloCode\n * all use `.agents/skills/`) are deduplicated: the directory appears once\n * in the output, with all the harness ids listed in `usedBy`.\n *\n * The `path` is returned relative to the project root (caller is responsible\n * for joining with the project cwd).\n */\nexport function resolveTargets(harnessIds: string[], cwd: string = '.'): ResolvedTarget[] {\n    const map = new Map<string, ResolvedTarget>()\n\n    for (const id of harnessIds) {\n        const { installer } = getHarness(id)\n        collectFromInstaller(map, installer, id, cwd)\n    }\n\n    return Array.from(map.values())\n}\n\nfunction collectFromInstaller(\n    map: Map<string, ResolvedTarget>,\n    installer: Installer,\n    harnessId: string,\n    cwd: string\n): void {\n    const ext = installer.fileExtension\n    if (installer.workflowsDir) {\n        addTarget(map, joinPath(cwd, installer.workflowsDir), ext, harnessId)\n    } else if (installer.targetDir) {\n        addTarget(map, joinPath(cwd, installer.targetDir), ext, harnessId)\n    } else if (installer.skillsDir) {\n        addTarget(map, joinPath(cwd, installer.skillsDir), ext, harnessId)\n    }\n    if (installer.commandsDir) {\n        addTarget(map, joinPath(cwd, installer.commandsDir), ext, harnessId)\n    }\n}\n\nfunction addTarget(\n    map: Map<string, ResolvedTarget>,\n    path: string,\n    fileExtension: string,\n    harnessId: string\n): void {\n    const existing = map.get(path)\n    if (existing) {\n        if (!existing.usedBy.includes(harnessId)) {\n            existing.usedBy.push(harnessId)\n        }\n    } else {\n        map.set(path, { path, fileExtension, usedBy: [harnessId] })\n    }\n}\n\nfunction joinPath(a: string, b: string): string {\n    if (a === '.' || a === '') return b\n    if (b.startsWith('/')) return `${a}${b}`\n    return `${a}/${b}`\n}\n\n/**\n * Get the raw (validated) codes object, for advanced use cases.\n * Most callers should use the higher-level helpers above.\n */\nexport function getRawHarnessCodes(): HarnessCodes {\n    return codes\n}\n"],"mappings":"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"}

package/dist/workflows/protocol-crystallize.md

@@ -1,40 +1,36 @@
 ---
 name: protocol-crystallize
-description: 'Mandatory close-out before ending a session. Forces durable knowledge capture.'
+description: 'Close work with durable knowledge, truthful state and bounded current context.'
 ---
 
 # /crystallize — End session
 
-> **CRITICAL:** You MUST NOT ask the user what to crystallize. This is YOUR job. Reflect, decide, write. Then inform the user what you saved.
+> **CRITICAL:** You MUST NOT ask the user what to crystallize. Reflect, decide, write, then report.
 > **Authority:** If the user limited the work to read-only or no changes, do not modify any artifact; deliver the substantive answer and report that crystallization was skipped.
 
 ## STEP 1 — Worklog
 
-Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md` containing:
+Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md`: work performed, decisions and reasons, files changed, validation and next steps.
 
-- What was done
-- Key decisions and why
-- Files modified
-- Next steps for the next session
+## STEP 2 — Consolidate knowledge
 
-## STEP 2 — Route knowledge
+For each candidate ask: **Would this still guide a different future task?** Does it already exist, replace a claim, or belong in a narrower scope?
 
-For each candidate ask: **Would this still guide a different future task?**
+- Keep observations, measurements, chronology and completed actions in the worklog; update existing component documentation for operational explanation.
+- Route stable operating guidance to the narrowest `AGENT.md`, target requirements to `specs/`, and decision rationale to `decisions/`; update existing knowledge instead of duplicating it.
+- Consolidate or replace superseded and disproven guidance claim by claim, preserving valid restrictions in mixed paragraphs. Do not turn a current choice into a broader prohibition.
+- Do not turn historical worklogs, issues, or tasks into current specs/decisions without `/adopt`. Never create an `AGENT.md` based on file count alone.
+- Keep progress in `TASKS.md`; rewrite optional Current direction only when it helps the next session. Do not append a completed-task journal there or in `AGENT.md`.
 
-- **No:** keep observations, measurements, chronology, and completed actions in the worklog.
-- **Operational explanation:** update existing component documentation when within scope.
-- **Yes:** route stable operating guidance to the narrowest `AGENT.md`, target requirements to `specs/`, and decision rationale to `decisions/`; keep each non-duplicated.
+## STEP 3 — Close the work boundary
 
-Consolidate or replace superseded and disproven guidance; do not turn historical worklogs, issues, or tasks into current specs/decisions without `/adopt`. Never create an `AGENT.md` based on file count alone.
-
-## STEP 3 — Task status
-
-Mark `[x]` only if complete, `[!]` only if an unresolved dependency prevents progress, or keep `[/]` for partial work.
+Mark `[x]` only if complete, `[!]` only if an unresolved dependency prevents progress, or keep `[/]` for partial work. Record new completion dates; never fabricate old ones. Check linked issue acceptance separately.
+At a coherent completed-work boundary, run a bounded `/reconcile` archival pass when eligible history needs moving. Do not reorganize archives mechanically after every task or by calendar age.
+Verify the actual resulting text and links, not just the intended change; preserve unrelated concurrent edits.
 
 ## STEP 4 — User response
 
-First, deliver a self-contained answer to the original request: outcome, evidence, limitations, and relevant next step. Do not replace it with crystallization status.
-
+First deliver a self-contained answer to the original request: outcome, evidence, limitations, and relevant next step.
 Then append this supplementary handoff:
 
 `Crystallization — Task: [x] / [/] / [!] — [ID] | Worklog: .autonomos/worklogs/... | AGENT.md updated: [yes / no — reason]`

package/dist/workflows/protocol-issue.md

@@ -11,7 +11,7 @@ description: 'Optional intake for problems, proposals, and questions before choo
 ## STEP 1 — Build context
 
 1. Read root and applicable root → target `AGENT.md` files.
-2. Read `.autonomos/ISSUES.md` if it exists and search for duplicates.
+2. Read `.autonomos/ISSUES.md` if it exists and search for duplicates; targeted archived issue/ID lookup prevents duplicate intake and identifier reuse.
 3. Read related tasks or worklogs only when they provide evidence.
 
 ## STEP 2 — Record the signal

package/dist/workflows/protocol-reconcile.md

@@ -1,34 +1,35 @@
 ---
 name: protocol-reconcile
-description: 'Audit and safely reconcile accumulated drift across Autonomos artifacts.'
+description: 'Investigate drift, consolidate current knowledge and archive settled work.'
 ---
 
-# /reconcile — Audit and repair drift
+# /reconcile — Audit, repair and archive
 
-> Reconciliation is evidence-driven and bounded by user authority. Never guess through a semantic conflict or rewrite history to match the present.
+> Stay within user authority, including read access. Read-only runs propose changes only; do not inspect unrelated host configuration, secrets or production.
 
-## STEP 1 — Inventory and classify
+## STEP 1 — Bound and classify
 
-1. Read root and applicable scoped `AGENT.md` files, then current tasks, optional issues, relevant worklogs, linked documentation, and any existing `specs/` or `decisions/`.
-2. Classify each artifact as current guidance, current state, historical evidence, or version-pinned protocol content.
-3. Check protocol integrity with `autonomos status`; repair managed artifacts only through `autonomos update` when authorized.
+1. Read root and applicable scoped `AGENT.md`, current tasks/issues and relevant accepted records. Follow the protocol's archival criteria; search history only for a specific question.
+2. Classify individual claims as current guidance, current state, historical evidence, or version-pinned protocol content; a paragraph may mix them.
+3. Check managed integrity with `autonomos status` when available; repair managed artifacts only through authorized `autonomos update`.
 
-## STEP 2 — Detect drift
+## STEP 2 — Investigate
 
-Look for duplicates, contradictions, obsolete paths or technologies, misplaced knowledge, vague rules, broken references, and task/issue/worklog status mismatches.
+Look for duplicates, contradictions, obsolete paths or technologies, misplaced knowledge, broken references, and task/issue acceptance mismatches.
+Verify against authoritative repository source, configuration, tests, explicit decisions and targeted history. A configuration change is not a runtime observation; age, checkboxes and absent code alone do not prove obsolescence.
+Classify findings as **certain**, **uncertain**, or **historical-only**.
 
-## STEP 3 — Verify
+## STEP 3 — Consolidate and archive
 
-1. Test each finding against authoritative repository source, configuration, tests, and current scoped documentation.
-2. Use runtime or external evidence only when access is authorized and necessary.
-3. Classify the result as **certain**, **uncertain**, or **historical-only**.
+- **Certain:** make the smallest correction supported by evidence; preserve valid subclaims and applicable accepted requirements, decisions and temporary directives.
+- **Uncertain:** do not mutate the disputed facts; leave a visible uncertainty and identify the smallest verification needed.
+- **Historical-only:** preserve it outside default context when eligible; do not rewrite conclusions to match today.
+- Apply the protocol's archival eligibility to coherent work batches. Completing a child task does not resolve unmet parent criteria. Consolidate still-needed knowledge in its existing narrowest home first.
+- Use `/adopt` for history-to-artifact extraction into new specs/decisions; routine reconciliation may update existing guidance within authority.
+- Move eligible records to `.autonomos/archive/<batch>/`, preserve content/provenance/IDs and repair references. Update the topic index; retain only necessary current dependencies/outcomes, not permanent per-completion stubs.
 
-## STEP 4 — Reconcile
+## STEP 4 — Verify and report
 
-- **Certain:** make the smallest correction; consolidate duplicates, route misplaced content, and replace or remove disproven current guidance.
-- **Uncertain:** do not mutate the disputed facts; report evidence, conflict, and concrete resolution options to the user.
-- **Historical-only:** preserve it unless it exposes sensitive data or falsely claims to be current guidance.
-- Missing optional `specs/` or `decisions/` are adoption candidates; do not create them automatically.
-- Use `/adopt` for history-to-artifact extraction; keep `/reconcile` focused on bounded audit and correction.
-
-Record material corrections and validation in the task worklog. Re-run checks and stop when a second pass produces no deterministic changes.
+Re-read exact source text before edits, preserve unrelated concurrent changes, and verify links, IDs, acceptance states and current-context continuity without archives.
+Check the final proposed text for journals, duplicates and unsupported prohibitions; an explanation is not proof that the resulting text is correct.
+Record material changes and checks in the task worklog. Stop when a second pass produces no deterministic changes; distinguish recorded validation from checks actually run.

package/dist/workflows/protocol-session.md

@@ -10,7 +10,7 @@ description: 'Mandatory bootstrap for any new session. Invoke before any work be
 ## STEP 1 — Orient
 
 1. Read the root `AGENT.md`.
-2. Read `.autonomos/TASKS.md`.
+2. Read `.autonomos/TASKS.md`, including Current direction when present. Archives are not bootstrap context; search them only for a specific question.
 
 RESPOND with a **3-line max** summary of relevant project context. Do not continue without this response.
 

package/dist/workflows/protocol-task.md

@@ -14,7 +14,7 @@ description: 'Mandatory procedure before starting a new task. Invoke before touc
 1. From the target file/folder, walk up to the project root. Read every `AGENT.md` you find on that path (root → target).
 2. Read the linked issue when present; if resuming, read the task's most recent worklog.
 3. If present, read only relevant accepted specifications and decision records; drafts/proposals inform exploration, superseded records do not constrain work.
-4. Do not load unrelated worklogs or context branches.
+4. Do not load unrelated worklogs or context branches. Search archives only to resolve a specific question; reserve new IDs against current and archived registries.
 
 ## STEP 2 — Declare plan
 
@@ -27,7 +27,7 @@ Mark the task `[/]` in `.autonomos/TASKS.md`, then work.
 ## During execution
 
 1. **Before every non-trivial decision:** consult the relevant AGENT.md.
-2. Treat new information as a crystallization candidate, not an automatic `AGENT.md` entry.
+2. Treat new information as a crystallization candidate, not an automatic `AGENT.md` entry. Investigate and correct established in-scope drift proactively; preserve valid subclaims.
 3. Keep session evidence with the task; route durable guidance only during `/crystallize`.
 
 ## End of task

package/dist/workflows/protocol-workflows.test.ts

@@ -5,7 +5,7 @@ import { PROTOCOL_TEMPLATE } from '../templates/protocol'
 
 /**
  * Validates the content of all workflow files and the PROTOCOL_TEMPLATE.
- * These tests guard against regressions on the v0.6 design:
+ * These tests guard against regressions on the v0.7 design:
  * - No crystallization questions directed at the user
  * - No duplicated close-out procedures in session.md
  * - Scoped AGENT.md discovery (no CLI dependency in workflows)
@@ -116,7 +116,7 @@ describe('AGENT.md format rules — consistent across files', () => {
 // ---------------------------------------------------------------------------
 // 5. PROTOCOL_TEMPLATE — compact reference, no workflow duplication
 // ---------------------------------------------------------------------------
-describe('PROTOCOL_TEMPLATE — v0.6 design', () => {
+describe('PROTOCOL_TEMPLATE — v0.7 design', () => {
     it('does not contain Phase 1/2/3 workflow steps', () => {
         expect(PROTOCOL_TEMPLATE).not.toContain('Phase 1:')
         expect(PROTOCOL_TEMPLATE).not.toContain('Phase 2:')
@@ -182,7 +182,7 @@ describe('Durable-memory lifecycle', () => {
     it('retires stale guidance and rejects arbitrary file-count heuristics', () => {
         expect(crystallize).toContain('Consolidate or replace superseded and disproven guidance')
         expect(crystallize).toContain(
-            'do not turn historical worklogs, issues, or tasks into current specs/decisions'
+            'Do not turn historical worklogs, issues, or tasks into current specs/decisions'
         )
         expect(crystallize).toContain('Never create an `AGENT.md` based on file count alone')
     })
@@ -366,3 +366,37 @@ describe('Workflow brevity', () => {
         expect(lines).toBeLessThanOrEqual(maxLines)
     })
 })
+
+describe('Archival and current-context continuity', () => {
+    it('keeps history out of bootstrap and preserves current requirements', () => {
+        expect(session).toContain('Archives are not bootstrap context')
+        expect(PROTOCOL_TEMPLATE).toContain(
+            'Current context must support ordinary work without archives'
+        )
+        expect(PROTOCOL_TEMPLATE).toContain('dated temporary directives remain active')
+        expect(PROTOCOL_TEMPLATE).toContain('Applicable specs/decisions stay current independently')
+        expect(PROTOCOL_TEMPLATE).toContain(
+            'A completed child does not satisfy unmet parent acceptance criteria'
+        )
+    })
+    it('preserves evidence, identifiers and project ownership without calendar-driven archival', () => {
+        expect(PROTOCOL_TEMPLATE).toContain('Archived task and issue IDs remain reserved')
+        expect(PROTOCOL_TEMPLATE).toContain('repair relative paths when necessary')
+        expect(PROTOCOL_TEMPLATE).toContain(
+            'Installing a new protocol performs no automatic cleanup'
+        )
+        expect(reconcile).toContain('not permanent per-completion stubs')
+        expect(crystallize).toContain('Do not turn a current choice into a broader prohibition')
+        expect(crystallize).toContain(
+            'Do not reorganize archives mechanically after every task or by calendar age'
+        )
+    })
+    it('checks actual output and preserves valid parts of mixed claims', () => {
+        expect(reconcile).toContain('Re-read exact source text before edits')
+        expect(reconcile).toContain('preserve valid subclaims')
+        expect(reconcile).toContain('Check the final proposed text')
+        expect(crystallize).toContain('claim by claim')
+        expect(task).toContain('reserve new IDs against current and archived registries')
+        expect(issue).toContain('identifier reuse')
+    })
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autonomos/core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "SDK and core definitions for the Agent Protocol",
   "type": "module",
   "types": "./dist/index.d.mts",