@autonomos/core 0.0.2 → 0.3.0

package/dist/index.d.mts

@@ -1,12 +1,11 @@
 import { z } from "zod";
 
 //#region src/constants.d.ts
-
 /**
  * Agent Protocol Specification Version (Independent of Package versions)
  * This refers to the schema and behavioral contract version.
  */
-declare const PROTOCOL_VERSION = "0.1.0-alpha";
+declare const PROTOCOL_VERSION = "0.3.0-alpha";
 /**
  * Directory name for Autonomos configuration
  */
@@ -32,6 +31,217 @@ declare const AGENT_FILE = "AGENT.md";
  */
 declare const WORKLOGS_DIR = "worklogs";
 //#endregion
+//#region src/schemas/harness-codes.d.ts
+/**
+ * Installer configuration for a single harness.
+ *
+ * At least one of `workflowsDir`, `targetDir`, or `skillsDir` must be defined.
+ *
+ * - `workflowsDir`: Where session.md, task.md, crystallize.md are written.
+ *    Preferred field — used by most harnesses.
+ * - `targetDir`: Single directory (legacy, like Cline's .clinerules/workflows/).
+ * - `skillsDir`: Skills directory (legacy, for harnesses that don't distinguish
+ *    skills from workflows).
+ * - `commandsDir`: Additional commands directory (optional).
+ */
+declare const InstallerSchema: z.ZodEffects<z.ZodObject<{
+  workflowsDir: z.ZodOptional<z.ZodString>;
+  targetDir: z.ZodOptional<z.ZodString>;
+  skillsDir: z.ZodOptional<z.ZodString>;
+  commandsDir: z.ZodOptional<z.ZodString>;
+  globalTargetDir: z.ZodOptional<z.ZodString>;
+  fileExtension: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  fileExtension: string;
+  workflowsDir?: string | undefined;
+  targetDir?: string | undefined;
+  skillsDir?: string | undefined;
+  commandsDir?: string | undefined;
+  globalTargetDir?: string | undefined;
+}, {
+  fileExtension: string;
+  workflowsDir?: string | undefined;
+  targetDir?: string | undefined;
+  skillsDir?: string | undefined;
+  commandsDir?: string | undefined;
+  globalTargetDir?: string | undefined;
+}>, {
+  fileExtension: string;
+  workflowsDir?: string | undefined;
+  targetDir?: string | undefined;
+  skillsDir?: string | undefined;
+  commandsDir?: string | undefined;
+  globalTargetDir?: string | undefined;
+}, {
+  fileExtension: string;
+  workflowsDir?: string | undefined;
+  targetDir?: string | undefined;
+  skillsDir?: string | undefined;
+  commandsDir?: string | undefined;
+  globalTargetDir?: string | undefined;
+}>;
+/**
+ * A single harness entry.
+ */
+declare const HarnessSchema: z.ZodObject<{
+  name: z.ZodString;
+  preferred: z.ZodBoolean;
+  installer: z.ZodEffects<z.ZodObject<{
+    workflowsDir: z.ZodOptional<z.ZodString>;
+    targetDir: z.ZodOptional<z.ZodString>;
+    skillsDir: z.ZodOptional<z.ZodString>;
+    commandsDir: z.ZodOptional<z.ZodString>;
+    globalTargetDir: z.ZodOptional<z.ZodString>;
+    fileExtension: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    fileExtension: string;
+    workflowsDir?: string | undefined;
+    targetDir?: string | undefined;
+    skillsDir?: string | undefined;
+    commandsDir?: string | undefined;
+    globalTargetDir?: string | undefined;
+  }, {
+    fileExtension: string;
+    workflowsDir?: string | undefined;
+    targetDir?: string | undefined;
+    skillsDir?: string | undefined;
+    commandsDir?: string | undefined;
+    globalTargetDir?: string | undefined;
+  }>, {
+    fileExtension: string;
+    workflowsDir?: string | undefined;
+    targetDir?: string | undefined;
+    skillsDir?: string | undefined;
+    commandsDir?: string | undefined;
+    globalTargetDir?: string | undefined;
+  }, {
+    fileExtension: string;
+    workflowsDir?: string | undefined;
+    targetDir?: string | undefined;
+    skillsDir?: string | undefined;
+    commandsDir?: string | undefined;
+    globalTargetDir?: string | undefined;
+  }>;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  preferred: boolean;
+  installer: {
+    fileExtension: string;
+    workflowsDir?: string | undefined;
+    targetDir?: string | undefined;
+    skillsDir?: string | undefined;
+    commandsDir?: string | undefined;
+    globalTargetDir?: string | undefined;
+  };
+}, {
+  name: string;
+  preferred: boolean;
+  installer: {
+    fileExtension: string;
+    workflowsDir?: string | undefined;
+    targetDir?: string | undefined;
+    skillsDir?: string | undefined;
+    commandsDir?: string | undefined;
+    globalTargetDir?: string | undefined;
+  };
+}>;
+/**
+ * Root schema for the harness-codes configuration file.
+ */
+declare const HarnessCodesSchema: z.ZodObject<{
+  platforms: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    preferred: z.ZodBoolean;
+    installer: z.ZodEffects<z.ZodObject<{
+      workflowsDir: z.ZodOptional<z.ZodString>;
+      targetDir: z.ZodOptional<z.ZodString>;
+      skillsDir: z.ZodOptional<z.ZodString>;
+      commandsDir: z.ZodOptional<z.ZodString>;
+      globalTargetDir: z.ZodOptional<z.ZodString>;
+      fileExtension: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      fileExtension: string;
+      workflowsDir?: string | undefined;
+      targetDir?: string | undefined;
+      skillsDir?: string | undefined;
+      commandsDir?: string | undefined;
+      globalTargetDir?: string | undefined;
+    }, {
+      fileExtension: string;
+      workflowsDir?: string | undefined;
+      targetDir?: string | undefined;
+      skillsDir?: string | undefined;
+      commandsDir?: string | undefined;
+      globalTargetDir?: string | undefined;
+    }>, {
+      fileExtension: string;
+      workflowsDir?: string | undefined;
+      targetDir?: string | undefined;
+      skillsDir?: string | undefined;
+      commandsDir?: string | undefined;
+      globalTargetDir?: string | undefined;
+    }, {
+      fileExtension: string;
+      workflowsDir?: string | undefined;
+      targetDir?: string | undefined;
+      skillsDir?: string | undefined;
+      commandsDir?: string | undefined;
+      globalTargetDir?: string | undefined;
+    }>;
+  }, "strip", z.ZodTypeAny, {
+    name: string;
+    preferred: boolean;
+    installer: {
+      fileExtension: string;
+      workflowsDir?: string | undefined;
+      targetDir?: string | undefined;
+      skillsDir?: string | undefined;
+      commandsDir?: string | undefined;
+      globalTargetDir?: string | undefined;
+    };
+  }, {
+    name: string;
+    preferred: boolean;
+    installer: {
+      fileExtension: string;
+      workflowsDir?: string | undefined;
+      targetDir?: string | undefined;
+      skillsDir?: string | undefined;
+      commandsDir?: string | undefined;
+      globalTargetDir?: string | undefined;
+    };
+  }>>;
+}, "strip", z.ZodTypeAny, {
+  platforms: Record<string, {
+    name: string;
+    preferred: boolean;
+    installer: {
+      fileExtension: string;
+      workflowsDir?: string | undefined;
+      targetDir?: string | undefined;
+      skillsDir?: string | undefined;
+      commandsDir?: string | undefined;
+      globalTargetDir?: string | undefined;
+    };
+  }>;
+}, {
+  platforms: Record<string, {
+    name: string;
+    preferred: boolean;
+    installer: {
+      fileExtension: string;
+      workflowsDir?: string | undefined;
+      targetDir?: string | undefined;
+      skillsDir?: string | undefined;
+      commandsDir?: string | undefined;
+      globalTargetDir?: string | undefined;
+    };
+  }>;
+}>;
+type Installer = z.infer<typeof InstallerSchema>;
+type Harness = z.infer<typeof HarnessSchema>;
+type HarnessCodes = z.infer<typeof HarnessCodesSchema>;
+//#endregion
 //#region src/schemas/manifest.d.ts
 /**
  * Manifest Schema for .autonomos/manifest.json
@@ -107,9 +317,19 @@ declare const COMPLEXITIES: Complexity[];
  */
 declare function generateAgentTemplate(projectName?: string): string;
 /**
- * Default AGENT.md template
+ * Generate a minimal local AGENT.md for subdirectories.
+ * Free format by design — low friction encourages creation.
+ * @param dirName - Name of the directory
+ */
+declare function generateLocalAgentTemplate(dirName: string): string;
+/**
+ * Default root AGENT.md template
  */
 declare const AGENT_TEMPLATE: string;
+/**
+ * Default local AGENT.md template
+ */
+declare const LOCAL_AGENT_TEMPLATE: string;
 //#endregion
 //#region src/templates/manifest.d.ts
 /**
@@ -127,14 +347,19 @@ declare function parseManifest(content: string): Manifest;
 //#endregion
 //#region src/templates/protocol.d.ts
 /**
- * The immutable Protocol kernel template
- * This is the core specification that defines how AI agents interact with the project
+ * The Protocol kernel template — v0.3
+ *
+ * Design principles (v0.3):
+ * - PROTOCOL.md is a compact REFERENCE, not an executable workflow.
+ * - All step-by-step instructions live in the 3 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 = "# AI AGENT PROTOCOL (v0.1.0-alpha)\n\n> **SYSTEM INTEGRITY WARNING:** This file is the IMMUTABLE KERNEL of the project's AI workflow. Do not modify this file. Your instructions are to execute tasks and manage the project state based strictly on the definitions below.\n\n## 0. \u26A1 QUICK REFERENCE\n| Action | File / Command |\n|--------|----------------|\n| **Get Context** | Read `AGENT.md` (Root + Local) |\n| **Pick Task** | Check `.autonomos/TASKS.md` (Highest Priority) |\n| **Track Progress** | Update `.autonomos/TASKS.md` to `[/]` |\n| **Log Session** | Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md` |\n| **Finalize Task** | Update `.autonomos/TASKS.md` to `[x]` + Link Worklog |\n\n---\n\n## 1. BOOTSTRAPPING & INITIALIZATION\n**IF** this is your first time seeing this project, or if key system files are missing, you **MUST** initialize them immediately before doing any work.\n\n### Check for existence:\n1.  `.autonomos/TASKS.md` (task registry)\n2.  `.autonomos/worklogs/` (directory)\n3.  `AGENT.md` (at project root)\n\n**IF MISSING**, create them using the **TEMPLATES** defined in Section 2.\n\n---\n\n## 2. STRICT FILE STRUCTURES & TEMPLATES\nYou must adhere to these schemas. Do not invent new formats.\n\n### A. The Task Registry (`.autonomos/TASKS.md`)\n**Role:** The single source of truth for project state.\n**Location:** `.autonomos/TASKS.md`\n**Structure:**\n* Must use the specific Header and Legend.\n* Tasks must follow the format: `- [Status] **[ID]** Title of task `Priority` `Complexity``\n* Valid Priorities: `\uD83D\uDD34 Critical`, `\uD83D\uDFE0 High`, `\uD83D\uDD35 Medium`, `\u26AA Low`\n* Valid Complexities: `S`, `M`, `L`, `XL`\n* Valid Statuses: ` [ ] ` (Todo), `[/]` (In Progress), ` [x] ` (Done), ` [!] ` (Blocked)\n\n**TEMPLATE FOR NEW TASKS.md:**\n```markdown\n# 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- [ ] **[INIT-01]** Verify project structure and context `Priority: \uD83D\uDD34` `Complexity: S`\n\n## \uD83D\uDD2E Backlog\n*(Empty initially)*\n\n```\n\n### B. The Worklog (`.autonomos/worklogs/`)\n**Role:** Detailed history of complex tasks to save context tokens for future sessions.\n**Location:** `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID]-[slug].md`\n**Trigger:** Create a log when a task is finished, blocked, or if the session ends mid-task.\n\n**TEMPLATE FOR WORKLOG:**\n```markdown\n# WORKLOG: [TASK ID] [Task Name]\n**Date:** YYYY-MM-DD\n**Agent Status:** [Complete / Partial / Blocked]\n\n## \uD83D\uDCDD Description\nBrief summary of what was attempted/achieved.\n\n## \uD83D\uDEE0 Technical Details\n- **Files Modified:** List of files.\n- **Key Decisions:** Why did you choose this library/pattern?\n- **Challenges:** Any errors encountered and how they were solved.\n\n## \u23ED Next Steps / Context for Successor\nClear instructions for the next agent picking this up.\n```\n\n### C. The Context Anchor (`AGENT.md`)\n**Role:** Fractal knowledge base. Contains facts, stack details, and user preferences.\n**Location:** Root (`/AGENT.md`) and any subdirectory requiring specific context (e.g., `/packages/core/AGENT.md`).\n\n**TEMPLATE FOR AGENT.md:**\n```markdown\n---\nname: \"[Name of directory or project]\"\ntype: \"[project / package / module / script]\"\nstatus: \"[active / maintenance / poc]\"\n---\n# AGENT CONTEXT: [Directory Name or Root]\n\n## \uD83E\uDDE0 Context & Objectives\nWhat does this specific folder/module do?\n\n## \u2699\uFE0F Workflow & Preferences\n- **Commits:** [e.g. Conventional Commits]\n- **Language:** [English (default)]\n\n## \uD83C\uDFD7 Stack & Architecture\n- **Tech:** [Frameworks, Libs specific to this module]\n- **Patterns:** [Architecture patterns used]\n\n## \uD83D\uDCC1 Key Directories\n| Path | Description |\n|------|-------------|\n| `src/` | Source code |\n| `scripts/` | Build or utility scripts |\n\n## \u26A0\uFE0F Known Constraints\n*List any technical debts, missing features, or external limitations.*\n```\n\n## 3. CORE WORKFLOW (The Loop)\n\n### Phase 1: Context Loading (Read-Only)\n1.  **Read Root AGENT.md:** Absorb global preferences (Commit style, package manager, strict rules).\n2.  **Read .autonomos/TASKS.md:** Identify the highest priority task (\uD83D\uDD34 or \uD83D\uDFE0) that is not [x] or [!].\n3.  **Read Target AGENT.md:** If the task is in a subdirectory, check for a local `AGENT.md`.\n    *   *Note:* If the local `AGENT.md` contradicts the root, the local one wins for that specific scope.\n\n### Phase 2: Execution\n1.  **Mark the task as [/] (In Progress)** in `.autonomos/TASKS.md`.\n2.  **Perform the task.**\n3.  **Constraint Check:** Constantly refer to \"Workflow & Preferences\" in `AGENT.md`.\n\n### Phase 3: Crystallization (Write-Only)\nBefore ending the session, you **MUST**:\n\n1.  **Update AGENT.md:**\n    *   Did you learn a new command? Add it to \u2699\uFE0F Workflow.\n    *   Did you create a new complex module (>5 files)? Create a new `AGENT.md` inside it using the template above.\n\n2.  **Create Worklog:**\n    *   Write a file in `.autonomos/worklogs/` summarizing your work.\n\n3.  **Update TASKS.md:**\n    *   Mark task as [x] (Done) or [!] (Blocked).\n    *   Add a link to your worklog: `- [x] **[ID]** Title... *See: .autonomos/worklogs/...*`\n\n## 4. METADATA RULES\n*   **Language:** Documentation (`AGENT.md`, `TASKS.md`) must be written in **English** unless specified otherwise in User Preferences.\n*   **Tone:** Technical, concise, \"Fact-based\". No fluff.\n*   **Anonymity:** You are a continuous entity. Refer to previous work as \"we\" or \"the project\", not \"the previous AI\".\n";
+declare const PROTOCOL_TEMPLATE = "# AUTONOMOS PROTOCOL (v0.3.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| End a session | Read the `/crystallize` workflow |\n| Get context | Read `AGENT.md` (root \u2192 local) |\n| Find all AGENT.md | `find . -name AGENT.md -not -path '*/node_modules/*'` |\n| Pick next task | Open `.autonomos/TASKS.md`, pick highest priority not `[x]` |\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 | Fractal knowledge base (context, preferences, stack) |\n| `TASKS.md` | `.autonomos/TASKS.md` | Single source of truth for task state |\n| `worklogs/` | `.autonomos/worklogs/` | Session history (one file per session) |\n| `PROTOCOL.md` | `.autonomos/PROTOCOL.md` | This file \u2014 read-only reference |\n| `manifest.json` | `.autonomos/manifest.json` | Protocol version metadata |\n\n## AGENT.md Format Rules\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- 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## 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 = "# AI AGENT PROTOCOL (v0.1.0-alpha)\n\n> **SYSTEM INTEGRITY WARNING:** This file is the IMMUTABLE KERNEL of the project's AI workflow. Do not modify this file. Your instructions are to execute tasks and manage the project state based strictly on the definitions below.\n\n## 0. \u26A1 QUICK REFERENCE\n| Action | File / Command |\n|--------|----------------|\n| **Get Context** | Read `AGENT.md` (Root + Local) |\n| **Pick Task** | Check `.autonomos/TASKS.md` (Highest Priority) |\n| **Track Progress** | Update `.autonomos/TASKS.md` to `[/]` |\n| **Log Session** | Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md` |\n| **Finalize Task** | Update `.autonomos/TASKS.md` to `[x]` + Link Worklog |\n\n---\n\n## 1. BOOTSTRAPPING & INITIALIZATION\n**IF** this is your first time seeing this project, or if key system files are missing, you **MUST** initialize them immediately before doing any work.\n\n### Check for existence:\n1.  `.autonomos/TASKS.md` (task registry)\n2.  `.autonomos/worklogs/` (directory)\n3.  `AGENT.md` (at project root)\n\n**IF MISSING**, create them using the **TEMPLATES** defined in Section 2.\n\n---\n\n## 2. STRICT FILE STRUCTURES & TEMPLATES\nYou must adhere to these schemas. Do not invent new formats.\n\n### A. The Task Registry (`.autonomos/TASKS.md`)\n**Role:** The single source of truth for project state.\n**Location:** `.autonomos/TASKS.md`\n**Structure:**\n* Must use the specific Header and Legend.\n* Tasks must follow the format: `- [Status] **[ID]** Title of task `Priority` `Complexity``\n* Valid Priorities: `\uD83D\uDD34 Critical`, `\uD83D\uDFE0 High`, `\uD83D\uDD35 Medium`, `\u26AA Low`\n* Valid Complexities: `S`, `M`, `L`, `XL`\n* Valid Statuses: ` [ ] ` (Todo), `[/]` (In Progress), ` [x] ` (Done), ` [!] ` (Blocked)\n\n**TEMPLATE FOR NEW TASKS.md:**\n```markdown\n# 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- [ ] **[INIT-01]** Verify project structure and context `Priority: \uD83D\uDD34` `Complexity: S`\n\n## \uD83D\uDD2E Backlog\n*(Empty initially)*\n\n```\n\n### B. The Worklog (`.autonomos/worklogs/`)\n**Role:** Detailed history of complex tasks to save context tokens for future sessions.\n**Location:** `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID]-[slug].md`\n**Trigger:** Create a log when a task is finished, blocked, or if the session ends mid-task.\n\n**TEMPLATE FOR WORKLOG:**\n```markdown\n# WORKLOG: [TASK ID] [Task Name]\n**Date:** YYYY-MM-DD\n**Agent Status:** [Complete / Partial / Blocked]\n\n## \uD83D\uDCDD Description\nBrief summary of what was attempted/achieved.\n\n## \uD83D\uDEE0 Technical Details\n- **Files Modified:** List of files.\n- **Key Decisions:** Why did you choose this library/pattern?\n- **Challenges:** Any errors encountered and how they were solved.\n\n## \u23ED Next Steps / Context for Successor\nClear instructions for the next agent picking this up.\n```\n\n### C. The Context Anchor (`AGENT.md`)\n**Role:** Fractal knowledge base. Contains facts, stack details, and user preferences.\n**Location:** Root (`/AGENT.md`) and any subdirectory requiring specific context (e.g., `/packages/core/AGENT.md`).\n\n**TEMPLATE FOR AGENT.md:**\n```markdown\n---\nname: \"[Name of directory or project]\"\ntype: \"[project / package / module / script]\"\nstatus: \"[active / maintenance / poc]\"\n---\n# AGENT CONTEXT: [Directory Name or Root]\n\n## \uD83E\uDDE0 Context & Objectives\nWhat does this specific folder/module do?\n\n## \u2699\uFE0F Workflow & Preferences\n- **Commits:** [e.g. Conventional Commits]\n- **Language:** [English (default)]\n\n## \uD83C\uDFD7 Stack & Architecture\n- **Tech:** [Frameworks, Libs specific to this module]\n- **Patterns:** [Architecture patterns used]\n\n## \uD83D\uDCC1 Key Directories\n| Path | Description |\n|------|-------------|\n| `src/` | Source code |\n| `scripts/` | Build or utility scripts |\n\n## \u26A0\uFE0F Known Constraints\n*List any technical debts, missing features, or external limitations.*\n```\n\n## 3. CORE WORKFLOW (The Loop)\n\n### Phase 1: Context Loading (Read-Only)\n1.  **Read Root AGENT.md:** Absorb global preferences (Commit style, package manager, strict rules).\n2.  **Read .autonomos/TASKS.md:** Identify the highest priority task (\uD83D\uDD34 or \uD83D\uDFE0) that is not [x] or [!].\n3.  **Read Target AGENT.md:** If the task is in a subdirectory, check for a local `AGENT.md`.\n    *   *Note:* If the local `AGENT.md` contradicts the root, the local one wins for that specific scope.\n\n### Phase 2: Execution\n1.  **Mark the task as [/] (In Progress)** in `.autonomos/TASKS.md`.\n2.  **Perform the task.**\n3.  **Constraint Check:** Constantly refer to \"Workflow & Preferences\" in `AGENT.md`.\n\n### Phase 3: Crystallization (Write-Only)\nBefore ending the session, you **MUST**:\n\n1.  **Update AGENT.md:**\n    *   Did you learn a new command? Add it to \u2699\uFE0F Workflow.\n    *   Did you create a new complex module (>5 files)? Create a new `AGENT.md` inside it using the template above.\n\n2.  **Create Worklog:**\n    *   Write a file in `.autonomos/worklogs/` summarizing your work.\n\n3.  **Update TASKS.md:**\n    *   Mark task as [x] (Done) or [!] (Blocked).\n    *   Add a link to your worklog: `- [x] **[ID]** Title... *See: .autonomos/worklogs/...*`\n\n## 4. METADATA RULES\n*   **Language:** Documentation (`AGENT.md`, `TASKS.md`) must be written in **English** unless specified otherwise in User Preferences.\n*   **Tone:** Technical, concise, \"Fact-based\". No fluff.\n*   **Anonymity:** You are a continuous entity. Refer to previous work as \"we\" or \"the project\", not \"the previous AI\".\n";
+declare const PROTOCOL_TEMPLATE_V2026_1 = "# AUTONOMOS PROTOCOL (v0.3.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| End a session | Read the `/crystallize` workflow |\n| Get context | Read `AGENT.md` (root \u2192 local) |\n| Find all AGENT.md | `find . -name AGENT.md -not -path '*/node_modules/*'` |\n| Pick next task | Open `.autonomos/TASKS.md`, pick highest priority not `[x]` |\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 | Fractal knowledge base (context, preferences, stack) |\n| `TASKS.md` | `.autonomos/TASKS.md` | Single source of truth for task state |\n| `worklogs/` | `.autonomos/worklogs/` | Session history (one file per session) |\n| `PROTOCOL.md` | `.autonomos/PROTOCOL.md` | This file \u2014 read-only reference |\n| `manifest.json` | `.autonomos/manifest.json` | Protocol version metadata |\n\n## AGENT.md Format Rules\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- 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## 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
 /**
@@ -163,6 +388,40 @@ declare function generateWorklogContent(options: WorklogOptions): string;
  */
 declare function mapTaskStatusToWorklogStatus(status: TaskStatus): 'Complete' | 'Partial' | 'Blocked';
 //#endregion
+//#region src/parsers/agent-finder.d.ts
+/**
+ * Result of an ancestor lookup: a single AGENT.md entry that exists on the
+ * path between a target file or directory and the project root.
+ */
+interface AncestorAgent {
+  /** Absolute path to the directory containing the AGENT.md */
+  dir: string;
+  /** Absolute path to the AGENT.md file */
+  path: string;
+  /** Path of the directory relative to the project root */
+  relativeDir: string;
+}
+/**
+ * Return the ordered list of AGENT.md files that exist on the path from a
+ * target file or directory up to the project root. The order is root-first,
+ * then each intermediate directory, then the target directory itself.
+ *
+ * Non-existent AGENT.md files are silently skipped (the chain can have gaps).
+ *
+ * @param target - The absolute or project-relative path to a file or directory.
+ * @param projectRoot - The absolute path of the project root (where the root
+ *   AGENT.md lives). Defaults to the current working directory.
+ *
+ * @example
+ *   findAncestorAgents('/proj/apps/web/components/ui/button.tsx', '/proj')
+ *   // Returns, in order:
+ *   // - { dir: '/proj',                path: '/proj/AGENT.md' }
+ *   // - { dir: '/proj/apps/web',       path: '/proj/apps/web/AGENT.md' }
+ *   // (apps/, components/ skipped because they have no AGENT.md)
+ *   // (button.tsx itself is a file, so its parent dir is the last one checked)
+ */
+declare function findAncestorAgents(target: string, projectRoot?: string): AncestorAgent[];
+//#endregion
 //#region src/parsers/agent-parser.d.ts
 declare class AgentParser {
   /**
@@ -177,4 +436,55 @@ declare class TaskParser {
   private static mapStatus;
 }
 //#endregion
-export { AGENT_FILE, AGENT_TEMPLATE, AUTONOMOS_DIR, AgentConfig, AgentContext, AgentParser, AgentSection, COMPLEXITIES, Complexity, MANIFEST_FILE, Manifest, ManifestSchema, PRIORITIES, PROTOCOL_FILE, PROTOCOL_TEMPLATE, PROTOCOL_TEMPLATE_V2026_1, PROTOCOL_VERSION, Priority, TASKS_FILE, TASKS_TEMPLATE, Task, TaskParser, TaskStatus, WORKLOGS_DIR, createManifest, generateAgentTemplate, generateManifestContent, generateWorklogContent, mapTaskStatusToWorklogStatus, parseManifest };
+//#region src/harness-codes.d.ts
+/**
+ * Get a single harness entry by its id.
+ * Throws if the id is unknown.
+ */
+declare function getHarness(id: string): Harness;
+/**
+ * List all configured harnesses, as an array of {id, harness} pairs.
+ * Stable order: insertion order of the JSON object.
+ */
+declare function listHarnesses(): Array<{
+  id: string;
+  harness: Harness;
+}>;
+/**
+ * Get the list of preferred harnesses (shown as recommended options).
+ */
+declare function listPreferredHarnesses(): Array<{
+  id: string;
+  harness: Harness;
+}>;
+/**
+ * A resolved target directory where workflow files will be written.
+ * One per unique path, with the list of harness ids that share it.
+ */
+interface ResolvedTarget {
+  /** Absolute or project-relative path to the directory */
+  path: string;
+  /** File extension to use (e.g. ".md", ".agent.md") */
+  fileExtension: string;
+  /** Ids of the harnesses that will read from this directory */
+  usedBy: string[];
+}
+/**
+ * Resolve the unique target directories for a set of harness ids.
+ *
+ * Harnesses that share the same `skillsDir` (e.g. Codex, OpenCode, KiloCode
+ * all use `.agents/skills/`) are deduplicated: the directory appears once
+ * in the output, with all the harness ids listed in `usedBy`.
+ *
+ * The `path` is returned relative to the project root (caller is responsible
+ * for joining with the project cwd).
+ */
+declare function resolveTargets(harnessIds: string[], cwd?: string): ResolvedTarget[];
+/**
+ * Get the raw (validated) codes object, for advanced use cases.
+ * Most callers should use the higher-level helpers above.
+ */
+declare function getRawHarnessCodes(): HarnessCodes;
+//#endregion
+export { AGENT_FILE, AGENT_TEMPLATE, AUTONOMOS_DIR, AgentConfig, AgentContext, AgentParser, AgentSection, AncestorAgent, COMPLEXITIES, Complexity, 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, TASKS_FILE, TASKS_TEMPLATE, Task, TaskParser, TaskStatus, WORKLOGS_DIR, createManifest, findAncestorAgents, generateAgentTemplate, generateLocalAgentTemplate, generateManifestContent, generateWorklogContent, getHarness, getRawHarnessCodes, listHarnesses, listPreferredHarnesses, mapTaskStatusToWorklogStatus, parseManifest, resolveTargets };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +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/task-parser.ts","../src/harness-codes.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import{z as e}from"zod";import t from"js-yaml";const n=`0.1.0-alpha`,r=`.autonomos`,i=`manifest.json`,a=`PROTOCOL.md`,o=`TASKS.md`,s=`AGENT.md`,c=`worklogs`,l=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`)}),u=[`🔴 Critical`,`🟠 High`,`🔵 Medium`,`⚪ Low`],d=[`S`,`M`,`L`,`XL`];function f(e=`Project`){return`---
+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.3.0-alpha`,d=`.autonomos`,f=`manifest.json`,p=`PROTOCOL.md`,m=`TASKS.md`,h=`AGENT.md`,g=`worklogs`,_=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"}),v=e.object({name:e.string().min(1),preferred:e.boolean(),installer:_}),y=e.object({platforms:e.record(e.string(),v)}),b=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`)}),x=[`🔴 Critical`,`🟠 High`,`🔵 Medium`,`⚪ Low`],S=[`S`,`M`,`L`,`XL`];function C(e=`Project`){return`---
 name: "${e}"
 type: "project"
 status: "active"
@@ -29,153 +29,68 @@ status: "active"
 ## ⚠️ Known Constraints
 
 *List any technical debts, missing features, or external limitations.*
-`}const p=f();function m(e){let t=new Date().toISOString();return{protocolVersion:n,cliVersion:e,initializedAt:t,lastUpdated:t}}function h(e){return JSON.stringify(e,null,4)+`
-`}function g(e){let t=JSON.parse(e);return l.parse(t)}const _=`# AI AGENT PROTOCOL (v${n})
+`}function w(e){return`# AGENT: ${e}
 
-> **SYSTEM INTEGRITY WARNING:** This file is the IMMUTABLE KERNEL of the project's AI workflow. Do not modify this file. Your instructions are to execute tasks and manage the project state based strictly on the definitions below.
+- **Stack:** *(frameworks, libs specific to this module)*
+- **Conventions:** *(naming, exports, test patterns)*
+- **Constraints:** *(known issues, tech debt)*
+`}const T=C(),E=w(`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 b.parse(t)}const A=`# AUTONOMOS PROTOCOL (v${u})
 
-## 0. ⚡ QUICK REFERENCE
-| Action | File / Command |
-|--------|----------------|
-| **Get Context** | Read \`AGENT.md\` (Root + Local) |
-| **Pick Task** | Check \`.autonomos/TASKS.md\` (Highest Priority) |
-| **Track Progress** | Update \`.autonomos/TASKS.md\` to \`[/]\` |
-| **Log Session** | Create \`.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md\` |
-| **Finalize Task** | Update \`.autonomos/TASKS.md\` to \`[x]\` + Link Worklog |
+> This file defines the project's AI workflow contract. The workflows execute it. Do not duplicate workflow steps here.
 
----
+## Quick Reference
 
-## 1. BOOTSTRAPPING & INITIALIZATION
-**IF** this is your first time seeing this project, or if key system files are missing, you **MUST** initialize them immediately before doing any work.
+| Action | How |
+|---|---|
+| Start a session | Read the \`/session\` workflow |
+| Start a task | Read the \`/task\` workflow |
+| End a session | Read the \`/crystallize\` workflow |
+| Get context | Read \`AGENT.md\` (root → local) |
+| Find all AGENT.md | \`find . -name AGENT.md -not -path '*/node_modules/*'\` |
+| Pick next task | Open \`.autonomos/TASKS.md\`, pick highest priority not \`[x]\` |
+| Log session work | Create \`.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md\` |
 
-### Check for existence:
-1.  \`.autonomos/TASKS.md\` (task registry)
-2.  \`.autonomos/worklogs/\` (directory)
-3.  \`AGENT.md\` (at project root)
+## File Map
 
-**IF MISSING**, create them using the **TEMPLATES** defined in Section 2.
+| File | Location | Role |
+|---|---|---|
+| \`AGENT.md\` | Root + any subdirectory | Fractal knowledge base (context, preferences, stack) |
+| \`TASKS.md\` | \`.autonomos/TASKS.md\` | Single source of truth for task state |
+| \`worklogs/\` | \`.autonomos/worklogs/\` | Session history (one file per session) |
+| \`PROTOCOL.md\` | \`.autonomos/PROTOCOL.md\` | This file — read-only reference |
+| \`manifest.json\` | \`.autonomos/manifest.json\` | Protocol version metadata |
 
----
+## AGENT.md Format Rules
 
-## 2. STRICT FILE STRUCTURES & TEMPLATES
-You must adhere to these schemas. Do not invent new formats.
+**Root \`AGENT.md\`** — Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).
 
-### A. The Task Registry (\`.autonomos/TASKS.md\`)
-**Role:** The single source of truth for project state.
-**Location:** \`.autonomos/TASKS.md\`
-**Structure:**
-* Must use the specific Header and Legend.
-* Tasks must follow the format: \`- [Status] **[ID]** Title of task \`Priority\` \`Complexity\`\`
-* Valid Priorities: \`🔴 Critical\`, \`🟠 High\`, \`🔵 Medium\`, \`⚪ Low\`
-* Valid Complexities: \`S\`, \`M\`, \`L\`, \`XL\`
-* Valid Statuses: \` [ ] \` (Todo), \`[/]\` (In Progress), \` [x] \` (Done), \` [!] \` (Blocked)
+**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:
 
-**TEMPLATE FOR NEW TASKS.md:**
 \`\`\`markdown
-# 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.)
-> **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked
-
-## 🚀 Active Sprint
-- [ ] **[INIT-01]** Verify project structure and context \`Priority: 🔴\` \`Complexity: S\`
-
-## 🔮 Backlog
-*(Empty initially)*
-
+# AGENT: packages/core
+- Stack: TypeScript, Vitest, tsdown
+- Conventions: exports via src/index.ts, tests co-located (*.test.ts)
+- Constraint: template changes require workflow test updates
 \`\`\`
 
-### B. The Worklog (\`.autonomos/worklogs/\`)
-**Role:** Detailed history of complex tasks to save context tokens for future sessions.
-**Location:** \`.autonomos/worklogs/YYYY-MM-DD-[TASK_ID]-[slug].md\`
-**Trigger:** Create a log when a task is finished, blocked, or if the session ends mid-task.
-
-**TEMPLATE FOR WORKLOG:**
-\`\`\`markdown
-# WORKLOG: [TASK ID] [Task Name]
-**Date:** YYYY-MM-DD
-**Agent Status:** [Complete / Partial / Blocked]
-
-## 📝 Description
-Brief summary of what was attempted/achieved.
-
-## 🛠 Technical Details
-- **Files Modified:** List of files.
-- **Key Decisions:** Why did you choose this library/pattern?
-- **Challenges:** Any errors encountered and how they were solved.
-
-## ⏭ Next Steps / Context for Successor
-Clear instructions for the next agent picking this up.
-\`\`\`
-
-### C. The Context Anchor (\`AGENT.md\`)
-**Role:** Fractal knowledge base. Contains facts, stack details, and user preferences.
-**Location:** Root (\`/AGENT.md\`) and any subdirectory requiring specific context (e.g., \`/packages/core/AGENT.md\`).
-
-**TEMPLATE FOR AGENT.md:**
-\`\`\`markdown
----
-name: "[Name of directory or project]"
-type: "[project / package / module / script]"
-status: "[active / maintenance / poc]"
----
-# AGENT CONTEXT: [Directory Name or Root]
-
-## 🧠 Context & Objectives
-What does this specific folder/module do?
-
-## ⚙️ Workflow & Preferences
-- **Commits:** [e.g. Conventional Commits]
-- **Language:** [English (default)]
-
-## 🏗 Stack & Architecture
-- **Tech:** [Frameworks, Libs specific to this module]
-- **Patterns:** [Architecture patterns used]
-
-## 📁 Key Directories
-| Path | Description |
-|------|-------------|
-| \`src/\` | Source code |
-| \`scripts/\` | Build or utility scripts |
-
-## ⚠️ Known Constraints
-*List any technical debts, missing features, or external limitations.*
-\`\`\`
-
-## 3. CORE WORKFLOW (The Loop)
-
-### Phase 1: Context Loading (Read-Only)
-1.  **Read Root AGENT.md:** Absorb global preferences (Commit style, package manager, strict rules).
-2.  **Read .autonomos/TASKS.md:** Identify the highest priority task (🔴 or 🟠) that is not [x] or [!].
-3.  **Read Target AGENT.md:** If the task is in a subdirectory, check for a local \`AGENT.md\`.
-    *   *Note:* If the local \`AGENT.md\` contradicts the root, the local one wins for that specific scope.
-
-### Phase 2: Execution
-1.  **Mark the task as [/] (In Progress)** in \`.autonomos/TASKS.md\`.
-2.  **Perform the task.**
-3.  **Constraint Check:** Constantly refer to "Workflow & Preferences" in \`AGENT.md\`.
-
-### Phase 3: Crystallization (Write-Only)
-Before ending the session, you **MUST**:
+## Task Format
 
-1.  **Update AGENT.md:**
-    *   Did you learn a new command? Add it to ⚙️ Workflow.
-    *   Did you create a new complex module (>5 files)? Create a new \`AGENT.md\` inside it using the template above.
+\`- [Status] **[ID]** Title \\\`Priority\\\` \\\`Complexity\\\`\`
 
-2.  **Create Worklog:**
-    *   Write a file in \`.autonomos/worklogs/\` summarizing your work.
+| Status | Priority | Complexity |
+|---|---|---|
+| \`[ ]\` Todo | \`🔴 Critical\` | \`S\` Small |
+| \`[/]\` In Progress | \`🟠 High\` | \`M\` Medium |
+| \`[x]\` Done | \`🔵 Medium\` | \`L\` Large |
+| \`[!]\` Blocked | \`⚪ Low\` | \`XL\` Huge |
 
-3.  **Update TASKS.md:**
-    *   Mark task as [x] (Done) or [!] (Blocked).
-    *   Add a link to your worklog: \`- [x] **[ID]** Title... *See: .autonomos/worklogs/...*\`
+## Metadata Rules
 
-## 4. METADATA RULES
-*   **Language:** Documentation (\`AGENT.md\`, \`TASKS.md\`) must be written in **English** unless specified otherwise in User Preferences.
-*   **Tone:** Technical, concise, "Fact-based". No fluff.
-*   **Anonymity:** You are a continuous entity. Refer to previous work as "we" or "the project", not "the previous AI".
-`,v=_,y=`# PROJECT TASKS & ROADMAP
+- **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
 
 > **LEGEND**
 > **Priority:** [🔴 Critical] [🟠 High] [🔵 Medium] [⚪ Low]
@@ -189,7 +104,7 @@ Before ending the session, you **MUST**:
 ## 🔮 Backlog
 
 *(Add future tasks here)*
-`;function b(e){let t=e.date??new Date().toISOString().split(`T`)[0];return`# WORKLOG: [${e.taskId}] ${e.taskName}
+`;function N(e){let t=e.date??new Date().toISOString().split(`T`)[0];return`# WORKLOG: [${e.taskId}] ${e.taskName}
 **Date:** ${t}
 **Agent Status:** [${e.status}]
 
@@ -210,6 +125,7 @@ ${e.challenges.map(e=>`  - ${e}`).join(`
 ## ⏭ Next Steps / Context for Successor
 ${e.nextSteps.map(e=>`- ${e}`).join(`
 `)}
-`}function x(e){switch(e){case`DONE`:return`Complete`;case`BLOCKED`:return`Blocked`;default:return`Partial`}}var S=class{static parse(e){let n=e,r={},i=e.match(/^---\r?\n([\s\S]*?)\r?\n---/);if(i)try{r=t.load(i[1]),n=e.slice(i[0].length).trim()}catch(e){console.error(`Failed to parse Agent frontmatter:`,e)}let a=n.split(/\r?\n/),o=[],s=r.name??`Unknown Agent`,c=null,l=[];for(let e of a){if(e.startsWith(`# `)&&!r.name){let t=e.replace(`# `,``).trim();s=t.toUpperCase().startsWith(`AGENT CONTEXT:`)?t.slice(14).replace(/^[:\s-]+/,``).trim():t;continue}if(e.startsWith(`## `)){c&&(c.content=l.join(`
-`).trim(),o.push(c)),c={title:e.replace(`## `,``).trim(),content:``},l=[];continue}c&&l.push(e)}return c&&(c.content=l.join(`
-`).trim(),o.push(c)),{title:s,sections:o,metadata:r}}},C=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`}}};export{s as AGENT_FILE,p as AGENT_TEMPLATE,r as AUTONOMOS_DIR,S as AgentParser,d as COMPLEXITIES,i as MANIFEST_FILE,l as ManifestSchema,u as PRIORITIES,a as PROTOCOL_FILE,_ as PROTOCOL_TEMPLATE,v as PROTOCOL_TEMPLATE_V2026_1,n as PROTOCOL_VERSION,o as TASKS_FILE,y as TASKS_TEMPLATE,C as TaskParser,c as WORKLOGS_DIR,m as createManifest,f as generateAgentTemplate,h as generateManifestContent,b as generateWorklogContent,x as mapTaskStatusToWorklogStatus,g as parseManifest};
+`}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(`
+`).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}}},V=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 H=y.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 U(e){let t=H.platforms[e];if(!t){let t=Object.keys(H.platforms).join(`, `);throw Error(`Unknown harness: "${e}". Known harnesses: ${t}`)}return t}function W(){return Object.entries(H.platforms).map(([e,t])=>({id:e,harness:t}))}function G(){return W().filter(({harness:e})=>e.preferred)}function K(e,t=`.`){let n=new Map;for(let r of e){let{installer:e}=U(r);q(n,e,r,t)}return Array.from(n.values())}function q(e,t,n,r){let i=t.fileExtension;t.workflowsDir?J(e,Y(r,t.workflowsDir),i,n):t.targetDir?J(e,Y(r,t.targetDir),i,n):t.skillsDir&&J(e,Y(r,t.skillsDir),i,n),t.commandsDir&&J(e,Y(r,t.commandsDir),i,n)}function J(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 Y(e,t){return e===`.`||e===``?t:t.startsWith(`/`)?`${e}${t}`:`${e}/${t}`}function X(){return H}export{h as AGENT_FILE,T as AGENT_TEMPLATE,d as AUTONOMOS_DIR,B as AgentParser,S as COMPLEXITIES,y as HarnessCodesSchema,v as HarnessSchema,_ as InstallerSchema,E as LOCAL_AGENT_TEMPLATE,f as MANIFEST_FILE,b as ManifestSchema,x as PRIORITIES,p as PROTOCOL_FILE,A as PROTOCOL_TEMPLATE,j as PROTOCOL_TEMPLATE_V2026_1,u as PROTOCOL_VERSION,m as TASKS_FILE,M as TASKS_TEMPLATE,V as TaskParser,g as WORKLOGS_DIR,D as createManifest,F as findAncestorAgents,C as generateAgentTemplate,w as generateLocalAgentTemplate,O as generateManifestContent,N as generateWorklogContent,U as getHarness,X as getRawHarnessCodes,W as listHarnesses,G as listPreferredHarnesses,P as mapTaskStatusToWorklogStatus,k as parseManifest,K as resolveTargets};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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/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.3.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","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 session.md, task.md, crystallize.md 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\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.3\n *\n * Design principles (v0.3):\n * - PROTOCOL.md is a compact REFERENCE, not an executable workflow.\n * - All step-by-step instructions live in the 3 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| End a session | Read the \\`/crystallize\\` workflow |\n| Get context | Read \\`AGENT.md\\` (root → local) |\n| Find all AGENT.md | \\`find . -name AGENT.md -not -path '*/node_modules/*'\\` |\n| Pick next task | Open \\`.autonomos/TASKS.md\\`, pick highest priority not \\`[x]\\` |\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 | Fractal knowledge base (context, preferences, stack) |\n| \\`TASKS.md\\` | \\`.autonomos/TASKS.md\\` | Single source of truth for task state |\n| \\`worklogs/\\` | \\`.autonomos/worklogs/\\` | Session history (one file per session) |\n| \\`PROTOCOL.md\\` | \\`.autonomos/PROTOCOL.md\\` | This file — read-only reference |\n| \\`manifest.json\\` | \\`.autonomos/manifest.json\\` | Protocol version metadata |\n\n## AGENT.md Format Rules\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- 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## 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 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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"}

package/dist/workflows/protocol-crystallize.md

@@ -0,0 +1,39 @@
+---
+name: protocol-crystallize
+description: 'Mandatory close-out before ending a session. Forces durable knowledge capture.'
+---
+
+# /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.
+
+## STEP 1 — Worklog
+
+Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md` containing:
+
+- What was done
+- Key decisions and why
+- Files modified
+- Next steps for the next session
+
+## STEP 2 — Crystallize into AGENT.md
+
+Ask yourself silently — do NOT ask the user:
+
+1. **What did I learn?** (preferences, constraints, conventions, corrections) → Write to the relevant AGENT.md.
+2. **Is any AGENT.md entry now wrong?** → Replace in place, log the change in the worklog.
+3. **Should a new local AGENT.md exist?** (worked in a folder with >5 files and no AGENT.md) → Create one, free format.
+
+## STEP 3 — Task status
+
+Mark the task `[x]` (or `[!]` if blocked) in `.autonomos/TASKS.md`.
+
+## STEP 4 — Report
+
+RESPOND with exactly:
+
+- `Task: [x] / [!] — [ID]`
+- `Worklog: .autonomos/worklogs/...`
+- `AGENT.md updated: [yes / no — reason]`
+
+If you cannot produce these 3 lines, resume from Step 1.

package/dist/workflows/protocol-session.md

@@ -0,0 +1,32 @@
+---
+name: protocol-session
+description: 'Mandatory bootstrap for any new session. Invoke before any work begins.'
+---
+
+# /session — Start
+
+**You MUST complete Steps 1–3 before writing any code.**
+
+## STEP 1 — Load context
+
+1. Run `find . -name AGENT.md -not -path '*/node_modules/*'` and read every file found, root-first.
+2. Read the most recent file in `.autonomos/worklogs/` (if any).
+3. Read `.autonomos/TASKS.md`.
+
+RESPOND with a **3-line max** summary of what you retained. Do not continue without this response.
+
+## STEP 2 — Select task
+
+Pick the highest-priority task not marked `[x]` or `[!]`. If none, ask the user.
+
+RESPOND: `Task: [ID] — [title]. Starting.`
+
+## STEP 3 — Mark and begin
+
+Set the task to `[/]` in `.autonomos/TASKS.md`. Now you may work.
+
+## Session rules (apply until session ends)
+
+1. **Before every non-trivial decision:** check if an AGENT.md says something about it.
+2. **Every time you learn something new** (user correction, discovered convention, technical choice): write it to the relevant AGENT.md **now**, not later.
+3. **When the session ends:** invoke the `/crystallize` workflow. You cannot close without it.

package/dist/workflows/protocol-task.md

@@ -0,0 +1,31 @@
+---
+name: protocol-task
+description: 'Mandatory procedure before starting a new task. Invoke before touching code.'
+---
+
+# /task — Begin a task
+
+**Do NOT touch code before Step 2 is done.**
+
+## STEP 1 — Build fractal context
+
+1. From the target file/folder, walk up to the project root. Read every `AGENT.md` you find on that path (root → target).
+2. If no local `AGENT.md` exists at the target and you have worked in that folder before, propose creating one.
+
+## STEP 2 — Declare plan
+
+State in 3–5 steps what you will do. The user must be able to say OK or adjust.
+
+## STEP 3 — Execute
+
+Mark the task `[/]` in `.autonomos/TASKS.md`, then work.
+
+## During execution
+
+1. **Before every non-trivial decision:** consult the relevant AGENT.md.
+2. **Every new learning:** append to an AGENT.md immediately. If it contradicts an existing entry, replace in place and note the change in the worklog.
+3. **Root AGENT.md** uses the structured template. **Local AGENT.md** files are free format — one line is enough.
+
+## End of task
+
+Mark `[x]` in TASKS.md. Invoke `/crystallize`.

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

@@ -0,0 +1,157 @@
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { describe, expect, it } from 'vitest'
+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.3 design:
+ * - No crystallization questions directed at the user
+ * - No duplicated close-out procedures in session.md
+ * - find-based AGENT.md discovery (no CLI dependency in workflows)
+ * - Consistent AGENT.md format rules
+ * - Workflows are short enough to fit in LLM working memory
+ */
+
+function loadWorkflow(name: string): string {
+    return readFileSync(join(import.meta.dirname, name), 'utf-8')
+}
+
+const session = loadWorkflow('protocol-session.md')
+const crystallize = loadWorkflow('protocol-crystallize.md')
+const task = loadWorkflow('protocol-task.md')
+
+// ---------------------------------------------------------------------------
+// 1. Crystallization — agent-directed, never asks the user
+// ---------------------------------------------------------------------------
+describe('crystallize.md — self-directed crystallization', () => {
+    it('contains the MUST NOT ask the user rule', () => {
+        expect(crystallize).toContain('MUST NOT ask the user what to crystallize')
+    })
+
+    it('directs the agent to ask itself', () => {
+        expect(crystallize).toContain('Ask yourself silently')
+    })
+
+    it('does not contain a user-questioning pattern', () => {
+        const lower = crystallize.toLowerCase()
+        expect(lower).not.toMatch(/ask\s+the\s+user.*what.*learn/i)
+    })
+})
+
+// ---------------------------------------------------------------------------
+// 2. Session.md — no duplicated close-out, defers to crystallize
+// ---------------------------------------------------------------------------
+describe('session.md — clean separation of concerns', () => {
+    it('does not contain "FINAL STEP"', () => {
+        expect(session).not.toContain('FINAL STEP')
+    })
+
+    it('does not ask the user what to crystallize', () => {
+        const lower = session.toLowerCase()
+        expect(lower).not.toMatch(/ask(?:ed)?\s+the\s+user.*learn/i)
+        expect(lower).not.toMatch(/what did this session learn/i)
+    })
+
+    it('points to /crystallize for session close-out', () => {
+        expect(session).toContain('/crystallize')
+    })
+
+    it('does not duplicate worklog creation logic', () => {
+        expect(session).not.toMatch(/- \[ \] A worklog exists/)
+    })
+})
+
+// ---------------------------------------------------------------------------
+// 3. AGENT.md discovery — find-based, no CLI dependency
+// ---------------------------------------------------------------------------
+describe('AGENT.md discovery — universal method', () => {
+    it('session.md uses find as primary method', () => {
+        expect(session).toContain('find . -name AGENT.md')
+    })
+
+    it('task.md uses directory walk, not CLI', () => {
+        // task.md should instruct walking up the directory tree
+        expect(task).toContain('walk up')
+        // Should NOT require autonomos CLI as a mandatory step
+        expect(task).not.toContain('npx --yes @autonomos/cli')
+    })
+})
+
+// ---------------------------------------------------------------------------
+// 4. AGENT.md format rules — root vs local distinction
+// ---------------------------------------------------------------------------
+describe('AGENT.md format rules — consistent across files', () => {
+    it('session.md does not impose format on local AGENT.md', () => {
+        // Session rules should mention AGENT.md but not impose root template everywhere
+        expect(session).toContain('AGENT.md')
+    })
+
+    it('task.md clarifies root vs local format', () => {
+        expect(task).toContain('Root AGENT.md')
+        expect(task).toContain('free format')
+    })
+
+    it('crystallize.md allows free format for local files', () => {
+        expect(crystallize).toContain('free format')
+    })
+
+    it('PROTOCOL_TEMPLATE has explicit format rules section', () => {
+        expect(PROTOCOL_TEMPLATE).toContain('Format Rules')
+    })
+})
+
+// ---------------------------------------------------------------------------
+// 5. PROTOCOL_TEMPLATE — compact reference, no workflow duplication
+// ---------------------------------------------------------------------------
+describe('PROTOCOL_TEMPLATE — v0.3 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:')
+        expect(PROTOCOL_TEMPLATE).not.toContain('Phase 3:')
+    })
+
+    it('points to workflows as the executable contract', () => {
+        expect(PROTOCOL_TEMPLATE).toContain('/session')
+        expect(PROTOCOL_TEMPLATE).toContain('/task')
+        expect(PROTOCOL_TEMPLATE).toContain('/crystallize')
+    })
+
+    it('contains the quick reference table', () => {
+        expect(PROTOCOL_TEMPLATE).toContain('Quick Reference')
+    })
+
+    it('does not contain deprecated .ai/ paths', () => {
+        expect(PROTOCOL_TEMPLATE).not.toContain('.ai/')
+    })
+
+    it('uses .autonomos/ consistently', () => {
+        expect(PROTOCOL_TEMPLATE).toContain('.autonomos/TASKS.md')
+        expect(PROTOCOL_TEMPLATE).toContain('.autonomos/worklogs/')
+    })
+})
+
+// ---------------------------------------------------------------------------
+// 6. Workflow brevity — each must be concise enough for LLM working memory
+// ---------------------------------------------------------------------------
+describe('Workflow brevity', () => {
+    const maxLines = 35 // allowing some margin over the 30-line target
+
+    it(`session.md is ≤${maxLines} lines (excluding frontmatter)`, () => {
+        const body = session.replace(/^---[\s\S]*?---\n/, '')
+        const lines = body.trim().split('\n').length
+        expect(lines).toBeLessThanOrEqual(maxLines)
+    })
+
+    it(`task.md is ≤${maxLines} lines (excluding frontmatter)`, () => {
+        const body = task.replace(/^---[\s\S]*?---\n/, '')
+        const lines = body.trim().split('\n').length
+        expect(lines).toBeLessThanOrEqual(maxLines)
+    })
+
+    it(`crystallize.md is ≤${maxLines} lines (excluding frontmatter)`, () => {
+        const body = crystallize.replace(/^---[\s\S]*?---\n/, '')
+        const lines = body.trim().split('\n').length
+        expect(lines).toBeLessThanOrEqual(maxLines)
+    })
+})

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@autonomos/core",
-  "version": "0.0.2",
+  "version": "0.3.0",
   "description": "SDK and core definitions for the Agent Protocol",
   "type": "module",
-  "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "keywords": [
     "agent",
@@ -34,14 +33,14 @@
     "LICENSE"
   ],
   "devDependencies": {
+    "@tala-tools/eslint": "0.1.3",
+    "@tala-tools/prettier": "0.0.3",
+    "@tala-tools/tsconfig": "0.0.1",
+    "@tala-tools/tsdown": "0.1.3",
     "@types/js-yaml": "4.0.9",
     "typescript": "^5.0.0",
-    "@repo/eslint": "1.0.0",
-    "@repo/tsdown": "1.0.0",
-    "@repo/prettier": "1.0.0",
     "@repo/vitest": "1.0.0"
   },
-  "module": "./dist/index.mjs",
   "exports": {
     ".": "./dist/index.mjs",
     "./package.json": "./package.json"
@@ -58,7 +57,7 @@
     "format:check": "prettier \"**/*\" --ignore-unknown --list-different",
     "format:fix": "prettier \"**/*\" --ignore-unknown --write",
     "clean": "rimraf node_modules dist LICENSE",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsgo --noEmit",
     "test": "vitest",
     "test:ui": "vitest --ui",
     "test:run": "vitest run",