npm - @autonomos/core - Versions diffs - 0.1.0 → 0.3.1 - Mend

@autonomos/core 0.1.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/index.d.mts +87 -11
package/dist/index.d.mts.map +1 -1
package/dist/index.mjs +49 -152
package/dist/index.mjs.map +1 -1
package/dist/workflows/protocol-crystallize.md +19 -28
package/dist/workflows/protocol-session.md +17 -35
package/dist/workflows/protocol-task.md +15 -21
package/dist/workflows/protocol-workflows.test.ts +157 -0
package/package.json +1 -1

package/dist/index.d.mts CHANGED Viewed

@@ -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.2.0-alpha";
+declare const PROTOCOL_VERSION = "0.3.0-alpha";
 /**
  * Directory name for Autonomos configuration
  */
@@ -35,12 +35,17 @@ declare const WORKLOGS_DIR = "worklogs";
 /**
  * Installer configuration for a single harness.
  *
- * Either `targetDir` (single directory for both skills and commands, used by
- * Cline) or `skillsDir` (split mode, used by Claude Code, Codex, etc.) must be
- * defined. `commandsDir` is optional in split mode (some harnesses only support
- * skills, e.g. Codex).
+ * 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>;
@@ -48,24 +53,28 @@ declare const InstallerSchema: z.ZodEffects<z.ZodObject<{
   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;
@@ -78,6 +87,7 @@ 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>;
@@ -85,24 +95,28 @@ declare const HarnessSchema: z.ZodObject<{
     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;
@@ -113,6 +127,7 @@ declare const HarnessSchema: z.ZodObject<{
   preferred: boolean;
   installer: {
     fileExtension: string;
+    workflowsDir?: string | undefined;
     targetDir?: string | undefined;
     skillsDir?: string | undefined;
     commandsDir?: string | undefined;
@@ -123,6 +138,7 @@ declare const HarnessSchema: z.ZodObject<{
   preferred: boolean;
   installer: {
     fileExtension: string;
+    workflowsDir?: string | undefined;
     targetDir?: string | undefined;
     skillsDir?: string | undefined;
     commandsDir?: string | undefined;
@@ -137,6 +153,7 @@ declare const HarnessCodesSchema: 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>;
@@ -144,24 +161,28 @@ declare const HarnessCodesSchema: z.ZodObject<{
       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;
@@ -172,6 +193,7 @@ declare const HarnessCodesSchema: z.ZodObject<{
     preferred: boolean;
     installer: {
       fileExtension: string;
+      workflowsDir?: string | undefined;
       targetDir?: string | undefined;
       skillsDir?: string | undefined;
       commandsDir?: string | undefined;
@@ -182,6 +204,7 @@ declare const HarnessCodesSchema: z.ZodObject<{
     preferred: boolean;
     installer: {
       fileExtension: string;
+      workflowsDir?: string | undefined;
       targetDir?: string | undefined;
       skillsDir?: string | undefined;
       commandsDir?: string | undefined;
@@ -194,6 +217,7 @@ declare const HarnessCodesSchema: z.ZodObject<{
     preferred: boolean;
     installer: {
       fileExtension: string;
+      workflowsDir?: string | undefined;
       targetDir?: string | undefined;
       skillsDir?: string | undefined;
       commandsDir?: string | undefined;
@@ -206,6 +230,7 @@ declare const HarnessCodesSchema: z.ZodObject<{
     preferred: boolean;
     installer: {
       fileExtension: string;
+      workflowsDir?: string | undefined;
       targetDir?: string | undefined;
       skillsDir?: string | undefined;
       commandsDir?: string | undefined;
@@ -292,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
 /**
@@ -312,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.2.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| **Discover all AGENT.md files** | Run `autonomos agents` |\n| **Discover AGENT.md ancestors for a path** | Run `autonomos agents <path>` |\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**MUST be kept alive:** you may freely add to, edit, or correct an `AGENT.md` at any time. No format is imposed: one line is enough if it is clear. What matters is that the next session can use it.\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.  **Run `autonomos agents` to discover all other `AGENT.md` files in the project tree.** For each one relevant to the work ahead, read it too.\n3.  **Read .autonomos/TASKS.md:** Identify the highest priority task (\uD83D\uDD34 or \uD83D\uDFE0) that is not [x] or [!].\n4.  **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`.\n4.  **In-the-moment crystallization:** Every time you learn something important (the user corrects you, you discover a convention, you make a non-trivial technical choice), write it to the relevant `AGENT.md` IMMEDIATELY. Do NOT defer this to end of session.\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    *   Did anything you previously wrote turn out to be wrong? Append a correction note (do not erase).\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. HARNESS WORKFLOWS\n\nThe protocol is delivered to the agent through **workflow files** installed at the harness-specific target directory. The exact location depends on the harness (see `autonomos init --help`). Three workflows are available:\n\n* **`/session`** (`protocol-session.md`) \u2014 Mandatory bootstrap at the start of every session. Loads context, identifies the next task, marks it in progress.\n* **`/task`** (`protocol-task.md`) \u2014 Invoked at the start of a new task within an active session. Verifies local `AGENT.md`, declares a 3-5 step plan before touching code.\n* **`/crystallize`** (`protocol-crystallize.md`) \u2014 Mandatory close-out before saying \"session done\". Worklog + 3 crystallize questions + task status + final verification line.\n\n**You MUST invoke `/session` at the start of every session and `/crystallize` before ending it. These are not optional.** Skipping them breaks the protocol's memory loop.\n\nIf the project does not yet contain these workflow files, run `autonomos init` (or `autonomos init --harness <name>` to target a specific harness).\n\n## 5. 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.2.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| **Discover all AGENT.md files** | Run `autonomos agents` |\n| **Discover AGENT.md ancestors for a path** | Run `autonomos agents <path>` |\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**MUST be kept alive:** you may freely add to, edit, or correct an `AGENT.md` at any time. No format is imposed: one line is enough if it is clear. What matters is that the next session can use it.\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.  **Run `autonomos agents` to discover all other `AGENT.md` files in the project tree.** For each one relevant to the work ahead, read it too.\n3.  **Read .autonomos/TASKS.md:** Identify the highest priority task (\uD83D\uDD34 or \uD83D\uDFE0) that is not [x] or [!].\n4.  **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`.\n4.  **In-the-moment crystallization:** Every time you learn something important (the user corrects you, you discover a convention, you make a non-trivial technical choice), write it to the relevant `AGENT.md` IMMEDIATELY. Do NOT defer this to end of session.\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    *   Did anything you previously wrote turn out to be wrong? Append a correction note (do not erase).\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. HARNESS WORKFLOWS\n\nThe protocol is delivered to the agent through **workflow files** installed at the harness-specific target directory. The exact location depends on the harness (see `autonomos init --help`). Three workflows are available:\n\n* **`/session`** (`protocol-session.md`) \u2014 Mandatory bootstrap at the start of every session. Loads context, identifies the next task, marks it in progress.\n* **`/task`** (`protocol-task.md`) \u2014 Invoked at the start of a new task within an active session. Verifies local `AGENT.md`, declares a 3-5 step plan before touching code.\n* **`/crystallize`** (`protocol-crystallize.md`) \u2014 Mandatory close-out before saying \"session done\". Worklog + 3 crystallize questions + task status + final verification line.\n\n**You MUST invoke `/session` at the start of every session and `/crystallize` before ending it. These are not optional.** Skipping them breaks the protocol's memory loop.\n\nIf the project does not yet contain these workflow files, run `autonomos init` (or `autonomos init --harness <name>` to target a specific harness).\n\n## 5. 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
 /**
@@ -390,6 +430,42 @@ declare class AgentParser {
   static parse(markdown: string): AgentContext;
 }
 //#endregion
+//#region src/parsers/project-root.d.ts
+/**
+ * Find the directory that owns this project by walking up from `startDir`
+ * until we find a directory containing `.autonomos/` or `.git/`.
+ *
+ * Returns `null` if no such directory exists before we reach the
+ * filesystem root.
+ *
+ * Notes on behavior:
+ * - The search stops at the first directory that contains any of the
+ *   markers. For monorepos this is the monorepo root, not the package
+ *   directory the caller is sitting in.
+ * - A directory containing `.git/` is preferred over walking further up:
+ *   this prevents leaking into a parent repository in nested-worktree
+ *   setups. Callers that need the absolute git toplevel can run
+ *   `git rev-parse --show-toplevel` themselves after this returns.
+ *
+ * @param startDir - Absolute path to start the search from.
+ */
+declare function findProjectRoot(startDir: string): string | null;
+/**
+ * Check whether two absolute paths refer to the same directory.
+ *
+ * Resolves `.` / `..` segments before comparing, so `/a/b` and
+ * `/a/b/./` are considered the same.
+ */
+declare function isSamePath(a: string, b: string): boolean;
+/**
+ * Render a path relative to another path, with one guarantee that the
+ * default `path.relative` doesn't give us: we never return a value that
+ * starts with `..`. If `target` is not under `base`, we return the
+ * absolute resolved path of `target` so the caller can still show a
+ * useful location.
+ */
+declare function displayRelative(target: string, base: string): string;
+//#endregion
 //#region src/parsers/task-parser.d.ts
 declare class TaskParser {
   static parse(markdown: string): Task[];
@@ -446,5 +522,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, Harness, HarnessCodes, HarnessCodesSchema, HarnessSchema, Installer, InstallerSchema, 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, generateManifestContent, generateWorklogContent, getHarness, getRawHarnessCodes, listHarnesses, listPreferredHarnesses, mapTaskStatusToWorklogStatus, parseManifest, resolveTargets };
+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, displayRelative, findAncestorAgents, findProjectRoot, generateAgentTemplate, generateLocalAgentTemplate, generateManifestContent, generateWorklogContent, getHarness, getRawHarnessCodes, isSamePath, listHarnesses, listPreferredHarnesses, mapTaskStatusToWorklogStatus, parseManifest, resolveTargets };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map CHANGED Viewed

	@@ -1 +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/task-parser.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;;;;;AA9Bb;;;;AAA6B;AAK7B;~~cCCa~~,eAAA,EAAe,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAA5B;;cAea~~,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;;;;;~~ADpC1C~~;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;~~cIsChB~~,cAAA;;;;;~~AJtCb~~;iBKEgB,cAAA,CAAe,UAAA,WAAqB,QAAQ;;;ALF/B;iBKeb,uBAAA,CAAwB,QAAkB,EAAR,QAAQ;;;;iBAO1C,aAAA,CAAc,OAAA,WAAkB,QAAQ;;;;;;ALtBxD;cMEa,iBAAA;;;~~ANFgB~~;~~cM0KhB~~,yBAAA;;;;;;~~cC3KA~~,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;;;~~cCLnC~~,UAAA;EAAA,OACF,KAAA,CAAM,QAAA,WAAmB,IAAI;EAAA,eAsBrB,SAAA;AAAA;;;;;~~AXrBnB~~;;~~iBYcgB~~,UAAA,CAAW,EAAA,WAAa,OAAO;;~~AZdlB~~;AAK7B;;~~iBYsBgB~~,aAAA,IAAiB,KAAK;EAAG,EAAA;EAAY,OAAA,EAAS,OAAA;AAAA;;;;iBAO9C,sBAAA,IAA0B,KAAK;EAAG,EAAA;EAAY,OAAA,EAAS,OAAA;AAAA;;~~AZnB7C~~;AAK1B;;~~UYsBiB~~,cAAA;~~EZtBM~~;~~EYwBnB~~,IAAA;~~EZnBS~~;~~EYqBT~~,aAAA;;EAEA,MAAA;AAAA;~~AZlBJ~~;;;;AAAyB;;;;~~ACxBzB~~;;~~ADwBA~~,~~iBY~~+BgB,cAAA,CAAe,UAAA,YAAsB,GAAA,YAAoB,cAAc;;;;;~~iBAuDvE~~,kBAAA,IAAsB,YAAY"}
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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"}

package/dist/index.mjs CHANGED Viewed

@@ -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.2.0-alpha`,d=`.autonomos`,f=`manifest.json`,p=`PROTOCOL.md`,m=`TASKS.md`,h=`AGENT.md`,g=`worklogs`,_=e.object({targetDir:e.string().optional(),skillsDir:e.string().optional(),commandsDir:e.string().optional(),globalTargetDir:e.string().optional(),fileExtension:e.string()}).refine(e=>!!e.targetDir||!!e.skillsDir,{message:"Either `targetDir` or `skillsDir` must be defined for each harness"}),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`---
+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,171 +29,68 @@ status: "active"
 ## ⚠️ Known Constraints
 *List any technical debts, missing features, or external limitations.*
-`}const w=C();function T(e){let t=new Date().toISOString();return{protocolVersion:u,cliVersion:e,initializedAt:t,lastUpdated:t}}function E(e){return JSON.stringify(e,null,4)+`
-`}function D(e){let t=JSON.parse(e);return b.parse(t)}const O=`# AI AGENT PROTOCOL (v${u})
-> **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.
-## 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 |
-| **Discover all AGENT.md files** | Run \`autonomos agents\` |
-| **Discover AGENT.md ancestors for a path** | Run \`autonomos agents <path>\` |
+`}function w(e){return`# AGENT: ${e}
----
-## 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.
-### Check for existence:
-1.  \`.autonomos/TASKS.md\` (task registry)
-2.  \`.autonomos/worklogs/\` (directory)
-3.  \`AGENT.md\` (at project root)
-**IF MISSING**, create them using the **TEMPLATES** defined in Section 2.
----
-## 2. STRICT FILE STRUCTURES & TEMPLATES
-You must adhere to these schemas. Do not invent new formats.
-### 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)
-**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
+- **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})
-## 🚀 Active Sprint
-- [ ] **[INIT-01]** Verify project structure and context \`Priority: 🔴\` \`Complexity: S\`
-## 🔮 Backlog
-*(Empty initially)*
+> This file defines the project's AI workflow contract. The workflows execute it. Do not duplicate workflow steps here.
-\`\`\`
+## Quick Reference
-### 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.
+| 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\` |
-**TEMPLATE FOR WORKLOG:**
-\`\`\`markdown
-# WORKLOG: [TASK ID] [Task Name]
-**Date:** YYYY-MM-DD
-**Agent Status:** [Complete / Partial / Blocked]
+## File Map
-## 📝 Description
-Brief summary of what was attempted/achieved.
+| 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 |
-## 🛠 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.
+## AGENT.md Format Rules
-## ⏭ Next Steps / Context for Successor
-Clear instructions for the next agent picking this up.
-\`\`\`
+**Root \`AGENT.md\`** — Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).
-### 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\`).
-**MUST be kept alive:** you may freely add to, edit, or correct an \`AGENT.md\` at any time. No format is imposed: one line is enough if it is clear. What matters is that the next session can use it.
+**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 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.*
+# 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
 \`\`\`
-## 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.  **Run \`autonomos agents\` to discover all other \`AGENT.md\` files in the project tree.** For each one relevant to the work ahead, read it too.
-3.  **Read .autonomos/TASKS.md:** Identify the highest priority task (🔴 or 🟠) that is not [x] or [!].
-4.  **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\`.
-4.  **In-the-moment crystallization:** Every time you learn something important (the user corrects you, you discover a convention, you make a non-trivial technical choice), write it to the relevant \`AGENT.md\` IMMEDIATELY. Do NOT defer this to end of session.
-### Phase 3: Crystallization (Write-Only)
-Before ending the session, you **MUST**:
-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.
-    *   Did anything you previously wrote turn out to be wrong? Append a correction note (do not erase).
-2.  **Create Worklog:**
-    *   Write a file in \`.autonomos/worklogs/\` summarizing your work.
-3.  **Update TASKS.md:**
-    *   Mark task as [x] (Done) or [!] (Blocked).
-    *   Add a link to your worklog: \`- [x] **[ID]** Title... *See: .autonomos/worklogs/...*\`
-## 4. HARNESS WORKFLOWS
-The protocol is delivered to the agent through **workflow files** installed at the harness-specific target directory. The exact location depends on the harness (see \`autonomos init --help\`). Three workflows are available:
+## Task Format
-* **\`/session\`** (\`protocol-session.md\`) — Mandatory bootstrap at the start of every session. Loads context, identifies the next task, marks it in progress.
-* **\`/task\`** (\`protocol-task.md\`) — Invoked at the start of a new task within an active session. Verifies local \`AGENT.md\`, declares a 3-5 step plan before touching code.
-* **\`/crystallize\`** (\`protocol-crystallize.md\`) — Mandatory close-out before saying "session done". Worklog + 3 crystallize questions + task status + final verification line.
+\`- [Status] **[ID]** Title \\\`Priority\\\` \\\`Complexity\\\`\`
-**You MUST invoke \`/session\` at the start of every session and \`/crystallize\` before ending it. These are not optional.** Skipping them breaks the protocol's memory loop.
+| Status | Priority | Complexity |
+|---|---|---|
+| \`[ ]\` Todo | \`🔴 Critical\` | \`S\` Small |
+| \`[/]\` In Progress | \`🟠 High\` | \`M\` Medium |
+| \`[x]\` Done | \`🔵 Medium\` | \`L\` Large |
+| \`[!]\` Blocked | \`⚪ Low\` | \`XL\` Huge |
-If the project does not yet contain these workflow files, run \`autonomos init\` (or \`autonomos init --harness <name>\` to target a specific harness).
+## Metadata Rules
-## 5. 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".
-`,k=O,A=`# 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]
@@ -207,7 +104,7 @@ If the project does not yet contain these workflow files, run \`autonomos init\`
 ## 🔮 Backlog
 *(Add future tasks here)*
-`;function j(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}]
@@ -228,7 +125,7 @@ ${e.challenges.map(e=>`  - ${e}`).join(`
 ## ⏭ Next Steps / Context for Successor
 ${e.nextSteps.map(e=>`- ${e}`).join(`
 `)}
-`}function M(e){switch(e){case`DONE`:return`Complete`;case`BLOCKED`:return`Blocked`;default:return`Partial`}}function N(e,n=process.cwd()){let c=s(n),l=P(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=F(L(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:I(e,c)})}return f}function P(e,t){return i(e)?e:a(t,e)}function F(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 I(e,t){let n=o(t,e);return n===``?`.`:n}function L(e){try{return n(e).isDirectory()}catch{return!1}}var R=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 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}}},z=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 B=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:{targetDir:`.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:{skillsDir:`.claude/skills`,commandsDir:`.claude/commands`,fileExtension:`.md`}},codex:{name:`Codex`,preferred:!0,installer:{skillsDir:`.agents/skills`,fileExtension:`.md`,globalTargetDir:`~/.codex/skills`,_note:`OpenAI Codex. Uses the cross-tool .agents/skills/ standard.`}},antigravity:{name:`Antigravity`,preferred:!0,installer:{skillsDir:`.agent/skills`,fileExtension:`.md`,globalTargetDir:`~/.gemini/antigravity/skills`,_note:"Google Antigravity. Note the singular `.agent/` (NOT the cross-tool `.agents/` standard). Cannot be deduplicated with the others."}},opencode:{name:`OpenCode`,preferred:!0,installer:{skillsDir:`.agents/skills`,commandsDir:`.opencode/commands`,fileExtension:`.md`}},kilocode:{name:`KiloCode`,preferred:!0,installer:{skillsDir:`.agents/skills`,fileExtension:`.md`,globalTargetDir:`~/.kilocode/skills`}}}});function V(e){let t=B.platforms[e];if(!t){let t=Object.keys(B.platforms).join(`, `);throw Error(`Unknown harness: "${e}". Known harnesses: ${t}`)}return t}function H(){return Object.entries(B.platforms).map(([e,t])=>({id:e,harness:t}))}function U(){return H().filter(({harness:e})=>e.preferred)}function W(e,t=`.`){let n=new Map;for(let r of e){let{installer:e}=V(r);G(n,e,r,t)}return Array.from(n.values())}function G(e,t,n,r){let i=t.fileExtension;t.targetDir&&K(e,q(r,t.targetDir),i,n),t.skillsDir&&K(e,q(r,t.skillsDir),i,n),t.commandsDir&&K(e,q(r,t.commandsDir),i,n)}function K(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 q(e,t){return e===`.`||e===``?t:t.startsWith(`/`)?`${e}${t}`:`${e}/${t}`}function J(){return B}export{h as AGENT_FILE,w as AGENT_TEMPLATE,d as AUTONOMOS_DIR,R as AgentParser,S as COMPLEXITIES,y as HarnessCodesSchema,v as HarnessSchema,_ as InstallerSchema,f as MANIFEST_FILE,b as ManifestSchema,x as PRIORITIES,p as PROTOCOL_FILE,O as PROTOCOL_TEMPLATE,k as PROTOCOL_TEMPLATE_V2026_1,u as PROTOCOL_VERSION,m as TASKS_FILE,A as TASKS_TEMPLATE,z as TaskParser,g as WORKLOGS_DIR,T as createManifest,N as findAncestorAgents,C as generateAgentTemplate,E as generateManifestContent,j as generateWorklogContent,V as getHarness,J as getRawHarnessCodes,H as listHarnesses,U as listPreferredHarnesses,M as mapTaskStatusToWorklogStatus,D as parseManifest,W as resolveTargets};
+`).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=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 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 ee(){return K}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,G as TaskParser,g as WORKLOGS_DIR,D as createManifest,W as displayRelative,F as findAncestorAgents,H as findProjectRoot,C as generateAgentTemplate,w as generateLocalAgentTemplate,O as generateManifestContent,N as generateWorklogContent,q as getHarness,ee as getRawHarnessCodes,U as isSamePath,J as listHarnesses,Y as listPreferredHarnesses,P as mapTaskStatusToWorklogStatus,k as parseManifest,X as resolveTargets};
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +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/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.2.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 Either `targetDir` (single directory for both skills and commands, used by\n * Cline) or `skillsDir` (split mode, used by Claude Code, Codex, etc.) must be\n * defined. `commandsDir` is optional in split mode (some harnesses only support\n * skills, e.g. Codex).\n /\nexport const InstallerSchema = z\n .object({\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(data => Boolean(data.targetDir) \|\| Boolean(data.skillsDir), {\n message: 'Either `targetDir` or `skillsDir` must be defined for each harness',\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\nDescribe 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\nList any technical debts, missing features, or external limitations.\n`\n}\n\n/*\n Default AGENT.md template\n /\nexport const AGENT_TEMPLATE = generateAgentTemplate()\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 immutable Protocol kernel template\n * This is the core specification that defines how AI agents interact with the project\n /\nexport const PROTOCOL_TEMPLATE = `# AI AGENT PROTOCOL (v${PROTOCOL_VERSION})\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. ⚡ 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\| Discover all AGENT.md files \| Run \\`autonomos agents\\` \|\n\| Discover AGENT.md ancestors for a path \| Run \\`autonomos agents <path>\\` \|\n\n---\n\n## 1. BOOTSTRAPPING & INITIALIZATION\nIF 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\nIF 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\\`)\nRole: The single source of truth for project state.\nLocation: \\`.autonomos/TASKS.md\\`\nStructure:\n* Must use the specific Header and Legend.\n* Tasks must follow the format: \\`- [Status] [ID] Title of task \\`Priority\\` \\`Complexity\\`\\`\n* Valid Priorities: \\`🔴 Critical\\`, \\`🟠 High\\`, \\`🔵 Medium\\`, \\`⚪ Low\\`\n* Valid Complexities: \\`S\\`, \\`M\\`, \\`L\\`, \\`XL\\`\n* Valid Statuses: \\` [ ] \\` (Todo), \\`[/]\\` (In Progress), \\` [x] \\` (Done), \\` [!] \\` (Blocked)\n\nTEMPLATE FOR NEW TASKS.md:\n\\`\\`\\`markdown\n# 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- [ ] [INIT-01] Verify project structure and context \\`Priority: 🔴\\` \\`Complexity: S\\`\n\n## 🔮 Backlog\n(Empty initially)\n\n\\`\\`\\`\n\n### B. The Worklog (\\`.autonomos/worklogs/\\`)\nRole: Detailed history of complex tasks to save context tokens for future sessions.\nLocation: \\`.autonomos/worklogs/YYYY-MM-DD-[TASK_ID]-[slug].md\\`\nTrigger: Create a log when a task is finished, blocked, or if the session ends mid-task.\n\nTEMPLATE FOR WORKLOG:\n\\`\\`\\`markdown\n# WORKLOG: [TASK ID] [Task Name]\nDate: YYYY-MM-DD\nAgent Status: [Complete / Partial / Blocked]\n\n## 📝 Description\nBrief summary of what was attempted/achieved.\n\n## 🛠 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## ⏭ Next Steps / Context for Successor\nClear instructions for the next agent picking this up.\n\\`\\`\\`\n\n### C. The Context Anchor (\\`AGENT.md\\`)\nRole: Fractal knowledge base. Contains facts, stack details, and user preferences.\nLocation: Root (\\`/AGENT.md\\`) and any subdirectory requiring specific context (e.g., \\`/packages/core/AGENT.md\\`).\nMUST be kept alive: you may freely add to, edit, or correct an \\`AGENT.md\\` at any time. No format is imposed: one line is enough if it is clear. What matters is that the next session can use it.\n\nTEMPLATE 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## 🧠 Context & Objectives\nWhat does this specific folder/module do?\n\n## ⚙️ Workflow & Preferences\n- Commits: [e.g. Conventional Commits]\n- Language: [English (default)]\n\n## 🏗 Stack & Architecture\n- Tech: [Frameworks, Libs specific to this module]\n- Patterns: [Architecture patterns used]\n\n## 📁 Key Directories\n\| Path \| Description \|\n\|------\|-------------\|\n\| \\`src/\\` \| Source code \|\n\| \\`scripts/\\` \| Build or utility scripts \|\n\n## ⚠️ Known Constraints\nList 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. Run \\`autonomos agents\\` to discover all other \\`AGENT.md\\` files in the project tree. For each one relevant to the work ahead, read it too.\n3. Read .autonomos/TASKS.md: Identify the highest priority task (🔴 or 🟠) that is not [x] or [!].\n4. 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\\`.\n4. In-the-moment crystallization: Every time you learn something important (the user corrects you, you discover a convention, you make a non-trivial technical choice), write it to the relevant \\`AGENT.md\\` IMMEDIATELY. Do NOT defer this to end of session.\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 ⚙️ Workflow.\n * Did you create a new complex module (>5 files)? Create a new \\`AGENT.md\\` inside it using the template above.\n * Did anything you previously wrote turn out to be wrong? Append a correction note (do not erase).\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. HARNESS WORKFLOWS\n\nThe protocol is delivered to the agent through workflow files installed at the harness-specific target directory. The exact location depends on the harness (see \\`autonomos init --help\\`). Three workflows are available:\n\n* \\`/session\\` (\\`protocol-session.md\\`) — Mandatory bootstrap at the start of every session. Loads context, identifies the next task, marks it in progress.\n* \\`/task\\` (\\`protocol-task.md\\`) — Invoked at the start of a new task within an active session. Verifies local \\`AGENT.md\\`, declares a 3-5 step plan before touching code.\n* \\`/crystallize\\` (\\`protocol-crystallize.md\\`) — Mandatory close-out before saying \"session done\". Worklog + 3 crystallize questions + task status + final verification line.\n\nYou MUST invoke \\`/session\\` at the start of every session and \\`/crystallize\\` before ending it. These are not optional. Skipping them breaks the protocol's memory loop.\n\nIf the project does not yet contain these workflow files, run \\`autonomos init\\` (or \\`autonomos init --harness <name>\\` to target a specific harness).\n\n## 5. 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`\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}\nDate:* ${date}\nAgent 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.targetDir) {\n addTarget(map, joinPath(cwd, installer.targetDir), ext, harnessId)\n }\n 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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"}
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.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\nDescribe 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\nList 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\nRoot \\`AGENT.md\\`* — Must use the structured template (frontmatter + sections: Context, Workflow, Stack, Key Directories, Constraints).\n\nLocal \\`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}\nDate:* ${date}\nAgent 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":"oMAIA,MAAa,EAAmB,cAKnB,EAAgB,aAKhB,EAAgB,gBAKhB,EAAgB,cAKhB,EAAa,WAKb,EAAa,WAKb,EAAe,WCpBf,EAAkB,EAC1B,OAAO,CACJ,aAAc,EAAE,OAAO,CAAC,CAAC,SAAS,EAClC,UAAW,EAAE,OAAO,CAAC,CAAC,SAAS,EAC/B,UAAW,EAAE,OAAO,CAAC,CAAC,SAAS,EAC/B,YAAa,EAAE,OAAO,CAAC,CAAC,SAAS,EACjC,gBAAiB,EAAE,OAAO,CAAC,CAAC,SAAS,EACrC,cAAe,EAAE,OAAO,CAC5B,CAAC,CAAC,CACD,OACG,GAAQ,EAAQ,EAAK,cAAiB,EAAQ,EAAK,WAAc,EAAQ,EAAK,UAC9E,CACI,QAAS,6EACb,CACJ,EAKS,EAAgB,EAAE,OAAO,CAClC,KAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EACtB,UAAW,EAAE,QAAQ,EACrB,UAAW,CACf,CAAC,EAKY,EAAqB,EAAE,OAAO,CACvC,UAAW,EAAE,OAAO,EAAE,OAAO,EAAG,CAAa,CACjD,CAAC,ECvCY,EAAiB,EAAE,OAAO,CACnC,gBAAiB,EAAE,OAAO,CAAC,CAAC,SAAS,6CAA6C,EAClF,WAAY,EAAE,OAAO,CAAC,CAAC,SAAS,mDAAmD,EACnF,cAAe,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,yCAAyC,EACvF,YAAa,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,uCAAuC,CACvF,CAAC,ECuCY,EAAyB,CAAC,cAAe,UAAW,YAAa,OAAO,EACxE,EAA6B,CAAC,IAAK,IAAK,IAAK,IAAI,EC9C9D,SAAgB,EAAsB,EAAsB,UAAmB,CAC3E,MAAO;SACF,EAAY;;;;mBAIF,EAAY;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B/B,CAOA,SAAgB,EAA2B,EAAyB,CAChE,MAAO,YAAY,EAAQ;;;;;CAM/B,CAKA,MAAa,EAAiB,EAAsB,EAKvC,EAAuB,EAA2B,QAAQ,ECvDvE,SAAgB,EAAe,EAA8B,CACzD,IAAM,EAAM,IAAI,KAAK,CAAA,CAAE,YAAY,EACnC,MAAO,CACH,gBAAiB,EACjB,aACA,cAAe,EACf,YAAa,CACjB,CACJ,CAKA,SAAgB,EAAwB,EAA4B,CAChE,OAAO,KAAK,UAAU,EAAU,KAAM,CAAC,EAAI;CAC/C,CAKA,SAAgB,EAAc,EAA2B,CACrD,IAAM,EAAO,KAAK,MAAM,CAAO,EAC/B,OAAO,EAAe,MAAM,CAAI,CACpC,CClBA,MAAa,EAAoB,0BAA0B,EAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4D/D,EAA4B,ECpE5B,EAAiB;;;;;;;;;;;;;;ECc9B,SAAgB,EAAuB,EAAiC,CACpE,IAAM,EAAO,EAAQ,MAAQ,IAAI,KAAK,CAAA,CAAE,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAEjE,MAAO,eAAe,EAAQ,OAAO,IAAI,EAAQ,SAAS;YAClD,EAAK;qBACI,EAAQ,OAAO;;;EAGlC,EAAQ,YAAY;;;;EAIpB,EAAQ,cAAc,IAAI,GAAK,OAAO,GAAG,CAAC,CAAC,KAAK;CAAI,EAAE;;EAEtD,EAAQ,UAAU,IAAI,GAAK,OAAO,GAAG,CAAC,CAAC,KAAK;CAAI,EAAE;;EAElD,EAAQ,WAAW,IAAI,GAAK,OAAO,GAAG,CAAC,CAAC,KAAK;CAAI,EAAE;;;EAGnD,EAAQ,UAAU,IAAI,GAAK,KAAK,GAAG,CAAC,CAAC,KAAK;CAAI,EAAE;CAElD,CAKA,SAAgB,EACZ,EACkC,CAClC,OAAQ,EAAR,CACI,IAAK,OACD,MAAO,WACX,IAAK,UACD,MAAO,UACX,QACI,MAAO,SACf,CACJ,CCjBA,SAAgB,EACZ,EACA,EAAsB,QAAQ,IAAI,EACnB,CACf,IAAM,EAAU,EAAQ,CAAW,EAC7B,EAAY,EAAmB,EAAQ,CAAO,EAG9C,EAAY,EAAS,EAAS,CAAS,EAC7C,GAAI,EAAU,WAAW,IAAI,GAAK,EAAW,CAAS,EAClD,MAAU,MACN,WAAW,EAAO,iCAAiC,EAAQ,6DAE/D,EAOJ,IAAM,EAAO,EADK,EAAY,CAAS,EAAI,EAAY,EAAQ,CAAS,EAC5B,CAAO,EAE7C,EAA0B,CAAC,EACjC,IAAK,IAAM,KAAO,EAAM,CACpB,IAAM,EAAY,EAAK,EAAK,CAAU,EAClC,EAAW,CAAS,GACpB,EAAO,KAAK,CACR,MACA,KAAM,EACN,YAAa,EAAY,EAAK,CAAO,CACzC,CAAC,CAET,CAEA,OAAO,CACX,CAMA,SAAS,EAAmB,EAAgB,EAAyB,CAEjE,OADI,EAAW,CAAM,EAAU,EACxB,EAAK,EAAS,CAAM,CAC/B,CAOA,SAAS,EAAoB,EAAkB,EAA2B,CACtE,IAAM,EAAM,EAAS,EAAS,CAAQ,EACtC,GAAI,IAAQ,IAAM,IAAQ,IACtB,MAAO,CAAC,CAAO,EAGnB,IAAM,EAAW,EAAI,MAAM,CAAG,CAAC,CAAC,OAAO,GAAK,IAAM,IAAM,IAAM,GAAG,EAC3D,EAAkB,CAAC,CAAO,EAC5B,EAAM,EACV,IAAK,IAAM,KAAO,EACd,EAAM,EAAK,EAAK,CAAG,EACnB,EAAM,KAAK,CAAG,EAElB,OAAO,CACX,CAMA,SAAS,EAAY,EAAa,EAAyB,CACvD,IAAM,EAAM,EAAS,EAAS,CAAG,EACjC,OAAO,IAAQ,GAAK,IAAM,CAC9B,CAEA,SAAS,EAAY,EAAoB,CACrC,GAAI,CACA,OAAO,EAAS,CAAC,CAAC,CAAC,YAAY,CACnC,MAAQ,CACJ,MAAO,EACX,CACJ,CCpHA,IAAa,EAAb,KAAyB,CAIrB,OAAO,MAAM,EAAgC,CACzC,IAAI,EAAU,EACV,EAAgC,CAAC,EAI/B,EAAQ,EAAS,MAAM,6BAAgB,EAC7C,GAAI,EACA,GAAI,CACA,EAAW,EAAK,KAAK,EAAM,EAAY,EACvC,EAAU,EAAS,MAAM,EAAM,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,CACnD,OAAS,EAAG,CACR,QAAQ,MAAM,qCAAsC,CAAC,CACzD,CAGJ,IAAM,EAAQ,EAAQ,MAAM,OAAO,EAC7B,EAA2B,CAAC,EAC9B,EAAQ,EAAS,MAAQ,gBACzB,EAAsC,KACtC,EAA2B,CAAC,EAEhC,IAAK,IAAM,KAAQ,EAAO,CAEtB,GAAI,EAAK,WAAW,IAAI,GAAK,CAAC,EAAS,KAAM,CACzC,IAAM,EAAW,EAAK,QAAQ,KAAM,EAAE,CAAC,CAAC,KAAK,EAE7C,AAMI,EANA,EAAS,YAAY,CAAC,CAAC,WAAW,gBAAgB,EAC1C,EACH,MAAM,EAAE,CAAC,CACT,QAAQ,WAAY,EAAE,CAAC,CACvB,KAAK,EAEF,EAEZ,QACJ,CAGA,GAAI,EAAK,WAAW,KAAK,EAAG,CAEpB,IACA,EAAe,QAAU,EAAe,KAAK;CAAI,CAAC,CAAC,KAAK,EACxD,EAAS,KAAK,CAAc,GAGhC,EAAiB,CACb,MAAO,EAAK,QAAQ,MAAO,EAAE,CAAC,CAAC,KAAK,EACpC,QAAS,EACb,EACA,EAAiB,CAAC,EAClB,QACJ,CAGI,GACA,EAAe,KAAK,CAAI,CAEhC,CAQA,OALI,IACA,EAAe,QAAU,EAAe,KAAK;CAAI,CAAC,CAAC,KAAK,EACxD,EAAS,KAAK,CAAc,GAGzB,CACH,QACA,WACA,UACJ,CACJ,CACJ,EC9DA,MAAM,EAAkB,CAAC,EAAe,MAAM,EAoB9C,SAAgB,EAAgB,EAAiC,CAC7D,GAAI,CAAC,EAAU,OAAO,KAEtB,IAAI,EADU,EAAQ,CACJ,EAElB,OAAa,CACT,GAAI,EAAgB,KAAK,GAAU,EAAW,EAAK,EAAS,CAAM,CAAC,CAAC,EAChE,OAAO,EAEX,IAAM,EAAS,EAAQ,CAAO,EAC9B,GAAI,IAAW,EAAS,OAAO,KAC/B,EAAU,CACd,CACJ,CAQA,SAAgB,EAAW,EAAW,EAAoB,CAEtD,MADI,CAAC,GAAK,CAAC,EAAU,GACd,EAAQ,CAAC,IAAM,EAAQ,CAAC,CACnC,CASA,SAAgB,EAAgB,EAAgB,EAAsB,CAClE,IAAM,EAAM,EAAS,EAAM,CAAM,EAKjC,OAJI,IAAQ,IAAM,IAAQ,IAAY,IAClC,EAAI,WAAW,KAAK,GAAK,GAAK,IAAQ,MAAQ,EAAW,CAAG,EACrD,EAAQ,CAAM,EAElB,CACX,CC3EA,IAAa,EAAb,KAAwB,CACpB,OAAO,MAAM,EAA0B,CACnC,IAAM,EAAgB,CAAC,EACjB,EAAQ,EAAS,MAAM,OAAO,EAC9B,EAAY,2EAElB,IAAK,IAAM,KAAQ,EAAO,CACtB,IAAM,EAAQ,EAAK,MAAM,CAAS,EAClC,GAAI,EAAO,CACP,GAAM,EAAG,EAAa,IAAK,EAAK,GAAI,EAAQ,GAAI,EAAW,GAAI,EAAa,IACxE,EACJ,EAAM,KAAK,CACP,KACA,MAAO,EAAM,KAAK,EACR,WACE,aACZ,OAAQ,KAAK,UAAU,CAAU,CACrC,CAAC,CACL,CACJ,CACA,OAAO,CACX,CAEA,OAAe,UAAU,EAA0B,CAC/C,OAAQ,EAAR,CACI,IAAK,IACD,MAAO,OACX,IAAK,IACD,MAAO,cACX,IAAK,IACD,MAAO,OACX,IAAK,IACD,MAAO,UACX,QACI,MAAO,MACf,CACJ,CACJ,EE3BA,MAAM,EAAsB,EAAmB,MAAMA,2kDAAAA,CAAgB,EAMrE,SAAgB,EAAW,EAAqB,CAC5C,IAAM,EAAQ,EAAM,UAAU,GAC9B,GAAI,CAAC,EAAO,CACR,IAAM,EAAQ,OAAO,KAAK,EAAM,SAAS,CAAC,CAAC,KAAK,IAAI,EACpD,MAAU,MAAM,qBAAqB,EAAG,sBAAsB,GAAO,CACzE,CACA,OAAO,CACX,CAMA,SAAgB,GAAyD,CACrE,OAAO,OAAO,QAAQ,EAAM,SAAS,CAAC,CAAC,KAAK,CAAC,EAAI,MAAc,CAAE,KAAI,SAAQ,EAAE,CACnF,CAKA,SAAgB,GAAkE,CAC9E,OAAO,EAAc,CAAC,CAAC,QAAQ,CAAE,aAAc,EAAQ,SAAS,CACpE,CAyBA,SAAgB,EAAe,EAAsB,EAAc,IAAuB,CACtF,IAAM,EAAM,IAAI,IAEhB,IAAK,IAAM,KAAM,EAAY,CACzB,GAAM,CAAE,aAAc,EAAW,CAAE,EACnC,EAAqB,EAAK,EAAW,EAAI,CAAG,CAChD,CAEA,OAAO,MAAM,KAAK,EAAI,OAAO,CAAC,CAClC,CAEA,SAAS,EACL,EACA,EACA,EACA,EACI,CACJ,IAAM,EAAM,EAAU,cAClB,EAAU,aACV,EAAU,EAAK,EAAS,EAAK,EAAU,YAAY,EAAG,EAAK,CAAS,EAC7D,EAAU,UACjB,EAAU,EAAK,EAAS,EAAK,EAAU,SAAS,EAAG,EAAK,CAAS,EAC1D,EAAU,WACjB,EAAU,EAAK,EAAS,EAAK,EAAU,SAAS,EAAG,EAAK,CAAS,EAEjE,EAAU,aACV,EAAU,EAAK,EAAS,EAAK,EAAU,WAAW,EAAG,EAAK,CAAS,CAE3E,CAEA,SAAS,EACL,EACA,EACA,EACA,EACI,CACJ,IAAM,EAAW,EAAI,IAAI,CAAI,EACzB,EACK,EAAS,OAAO,SAAS,CAAS,GACnC,EAAS,OAAO,KAAK,CAAS,EAGlC,EAAI,IAAI,EAAM,CAAE,OAAM,gBAAe,OAAQ,CAAC,CAAS,CAAE,CAAC,CAElE,CAEA,SAAS,EAAS,EAAW,EAAmB,CAG5C,OAFI,IAAM,KAAO,IAAM,GAAW,EAC9B,EAAE,WAAW,GAAG,EAAU,GAAG,IAAI,IAC9B,GAAG,EAAE,GAAG,GACnB,CAMA,SAAgB,IAAmC,CAC/C,OAAO,CACX"}

package/dist/workflows/protocol-crystallize.md CHANGED Viewed

@@ -1,48 +1,39 @@
 ---
 name: protocol-crystallize
-description: 'Mandatory close-out procedure for any session. Invoked before declaring the session done. Forces the agent to crystallize learnings into AGENT.md files.'
+description: 'Mandatory close-out before ending a session. Forces durable knowledge capture.'
 ---
-# Protocol Crystallize
+# /crystallize — End session
-**Goal:** Convert session activity into durable project knowledge.
-**Your Role:** Reflective agent that improves the project for the next session.
-## STEP 0 — STOP
-DO NOT close the session before every step below is complete.
+> **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 or complete `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md`. Free format, but MUST contain:
-- A summary of what was done
-- The technical decisions made and why
-- The files modified
-- Clear next steps (for the next session)
-## STEP 2 — Crystallize into AGENT.md files
-Ask yourself these three questions. For each, you MUST answer honestly. Do NOT say "nothing new".
+Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md` containing:
-**Question 1:** `What did I learn of significance about this project during this session?` (preferences, constraints, discovered conventions, user corrections, etc.)
+- What was done
+- Key decisions and why
+- Files modified
+- Next steps for the next session
-If the answer is not `nothing`, write it to the relevant AGENT.md (root or subfolder). No format is imposed. One line is enough if it is clear.
+## STEP 2 — Crystallize into AGENT.md
-**Question 2:** `Has any AGENT.md entry been contradicted or superseded?` If yes, update the relevant AGENT.md entry **in place** — the file is a current-state document, not a changelog. Then record the change in the worklog of this session (e.g. `PREF-007: GSAP → Motion, superseded by PREF-009`). Do NOT append superseded entries to AGENT.md; do NOT keep both.
+Ask yourself silently — do NOT ask the user:
-**Question 3:** `Is there something in the worklog that should have been in an AGENT.md and is not yet?` If yes, lift it out of the worklog and put it in the AGENT.md.
+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 as `[x]` (or `[!]` if blocked) in `.autonomos/TASKS.md`.
+Mark the task `[x]` (or `[!]` if blocked) in `.autonomos/TASKS.md`.
-## STEP 4 — Final verification
+## STEP 4 — Report
-RESPOND to the user with:
+RESPOND with exactly:
 - `Task: [x] / [!] — [ID]`
-- `Worklog created: .autonomos/worklogs/...`
-- `AGENT.md updated: [yes / no, and why]`
+- `Worklog: .autonomos/worklogs/...`
+- `AGENT.md updated: [yes / no — reason]`
-If you cannot produce these three lines, the session is not complete. Resume from Step 1.
+If you cannot produce these 3 lines, resume from Step 1.

package/dist/workflows/protocol-session.md CHANGED Viewed

@@ -1,50 +1,32 @@
 ---
 name: protocol-session
-description: 'Mandatory bootstrap for any new session on a project following the Autonomos protocol. Invoked at the start of every session, before any work begins.'
+description: 'Mandatory bootstrap for any new session. Invoke before any work begins.'
 ---
-# Protocol Session
+# /session — Start
-**Goal:** Load all project context, identify the next task, and establish a clean working state.
-**Your Role:** Disciplined agent that respects the project's accumulated knowledge.
+**You MUST complete Steps 1–3 before writing any code.**
-## STEP 0 — STOP
+## STEP 1 — Load context
-You are starting a new session. You MUST complete Steps 1, 2, and 3 before any other action.
+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`.
-DO NOT skip steps. DO NOT begin work before Step 3 is complete.
+RESPOND with a **3-line max** summary of what you retained. Do not continue without this response.
-## STEP 1 — Load context (three mandatory reads)
+## STEP 2 — Select task
-1. Read the root `AGENT.md`. This is your project identity.
-2. Run `autonomos agents` (no argument) to get the **full tree of all AGENT.md files in the project**. Read each one. This is your full fractal context — it lets you discover shared packages, cross-cutting conventions, and traps before starting any work.
-3. Read the most recent file in `.autonomos/worklogs/`. This is the memory of the previous session — read it to avoid repeating the same mistakes.
+Pick the highest-priority task not marked `[x]` or `[!]`. If none, ask the user.
-RESPOND to the user with a 5-line maximum summary of what you have retained. You are FORBIDDEN to continue without this response.
+RESPOND: `Task: [ID] — [title]. Starting.`
-## STEP 2 — Identify the next task
+## STEP 3 — Mark and begin
-Open `.autonomos/TASKS.md`. Identify the highest-priority task that is not yet `[x]`. If none qualify, ask the user what to work on.
+Set the task to `[/]` in `.autonomos/TASKS.md`. Now you may work.
-RESPOND with: `Task selected: [ID] — [title]. Starting.`
+## Session rules (apply until session ends)
-## STEP 3 — Mark the task and begin
-- Edit `.autonomos/TASKS.md` to change this task's status from `[ ]` to `[/]`.
-- NOW you may begin working.
-## REMINDER — applies to the entire session
-- **RAPPEL 1:** For every non-trivial decision (library choice, naming, structure, framework), STOP and ask: "Does an AGENT.md say something about this?" If yes, apply it. If no, propose the decision to the user.
-- **RAPPEL 2:** Every time you learn something important (the user corrects you, you discover a convention, you make a technical choice), STOP. Write it immediately to an AGENT.md (root or subfolder, depending on scope). Do NOT say "I'll note it later". It is NOW.
-- **RAPPEL 3:** No format is imposed on AGENT.md content. One line is enough if it's clear. What matters is that the next session can use it.
-## FINAL STEP (MANDATORY before saying "session done")
-You CANNOT end a session without all three of the following. DO NOT say "done" until each box is checked.
-- [ ] Task status in TASKS.md is `[x]` (or `[!]` if blocked)
-- [ ] A worklog exists at `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md` containing: what was done, decisions made, files modified, and clear next steps
-- [ ] You have asked the user the following question and recorded the answer in the worklog: `What did this session learn about this project that deserves to live in an AGENT.md?`
-When all three boxes are checked, you may say `session complete`.
+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 CHANGED Viewed

@@ -1,37 +1,31 @@
 ---
 name: protocol-task
-description: 'Mandatory procedure for starting a new task within an active session. Invoked at task start, before any code is touched.'
+description: 'Mandatory procedure before starting a new task. Invoke before touching code.'
 ---
-# Protocol Task
+# /task — Begin a task
-**Goal:** Confirm context, declare intent, and avoid scope drift.
-**Your Role:** Disciplined agent that respects local conventions.
+**Do NOT touch code before Step 2 is done.**
-## STEP 0 — STOP
+## STEP 1 — Build fractal context
-You are about to begin a new task. DO NOT touch code before the end of Step 2.
+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 1 — Build the precise fractal context for this task
+## STEP 2 — Declare plan
-1. Run `autonomos agents <path-to-target-file-or-folder>` to get the **ordered list of ancestor AGENT.md files** for the file or folder you'll be working in. The output is root-first; non-existent ancestors are silently skipped.
-2. Read each returned AGENT.md **in order** (root → target). This is your precise fractal context for this task.
-3. If no local `AGENT.md` exists at the target AND you have worked in that folder multiple times before, propose to the user: `This folder has no AGENT.md yet. Should we create one to crystallize the conventions we have established here?`
-## STEP 2 — Declare the plan
-State in 3 to 5 steps what you intend to do for this task. No more. The user must be able to say `OK` or adjust before you begin.
+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 TASKS.md, then execute your plan.
+Mark the task `[/]` in `.autonomos/TASKS.md`, then work.
-## DURING EXECUTION — three reminders
+## During execution
-- **REMINDER 1:** For every non-trivial decision, consult the relevant AGENT.md.
-- **REMINDER 2:** For every new learning, append a new line to an AGENT.md. If the new learning contradicts an existing one, replace the old entry in place and log the change in the worklog. AGENT.md stays a sharp current-state document, not a log.
-- **REMINDER 3:** You may edit any AGENT.md at any time. No format is imposed. What matters is that the next session can use it.
+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
+## End of task
-When the task is complete, mark it `[x]` in TASKS.md and invoke the `protocol-crystallize` workflow.
+Mark `[x]` in TASKS.md. Invoke `/crystallize`.

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

@@ -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 CHANGED Viewed

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