@autonomos/core 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,15 @@
+
+> @autonomos/core@0.0.1 build /home/runner/work/autonomos/autonomos/packages/core
+> tsdown
+
+ℹ tsdown v0.18.4 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/autonomos/autonomos/packages/core/tsdown.config.ts 
+ℹ entry: src/index.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/index.mjs     9.78 kB │ gzip: 4.19 kB
+ℹ dist/index.d.mts  17.09 kB │ gzip: 4.28 kB
+ℹ 2 files, total: 26.88 kB
+✔ Build complete in 1302ms
+✔ [publint] No issues found (329ms)
+🙏 Build succeeded!

package/LICENSE

@@ -0,0 +1,11 @@
+MIT License
+
+Copyright (c) 2026 Hakim Saoudi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+The Software may include icons that are licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0). Commercial use is allowed, but attribution is required for the use of these icons. See LICENSE-THIRD-PARTY for more details.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @autonomos/core
+
+The core logic and specification for the Autonomos Agent Protocol.
+
+## Overview
+
+This package contains the shared constants, types, templates, and parsers that define the Autonomos Agent Protocol. It is designed to be used by the CLI and other tools that need to interact with the protocol.
+
+## Features
+
+- **Constants**: Shared directory and file names (`.autonomos`, `manifest.json`, etc.)
+- **Templates**: Immutable templates for `PROTOCOL.md`, `TASKS.md`, `AGENT.md`, and `manifest.json`.
+- **Types**: TypeScript definitions for protocol entities (Tasks, Agents, Manifest).
+- **Parsers**: Tools for extracting structured data from markdown (e.g., `TaskParser`).
+
+## Usage
+
+```typescript
+import { PROTOCOL_VERSION, TaskParser } from '@autonomos/core'
+
+console.log(`Current Protocol Version: ${PROTOCOL_VERSION}`)
+
+const tasks = TaskParser.parse(markdownContent)
+```
+
+## Structure
+
+- `src/constants.ts`: Global constants and versioning.
+- `src/types.ts`: Core type definitions.
+- `src/templates/`: Protocol file templates.
+- `src/parsers/`: Logic for parsing protocol files.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,180 @@
+import { z } from "zod";
+
+//#region src/constants.d.ts
+
+/**
+ * Protocol version using SemVer
+ * Alpha phase - not yet published to npm
+ */
+declare const PROTOCOL_VERSION = "0.1.0-alpha";
+/**
+ * Directory name for Autonomos configuration
+ */
+declare const AUTONOMOS_DIR = ".autonomos";
+/**
+ * Manifest filename
+ */
+declare const MANIFEST_FILE = "manifest.json";
+/**
+ * Protocol filename
+ */
+declare const PROTOCOL_FILE = "PROTOCOL.md";
+/**
+ * Tasks filename
+ */
+declare const TASKS_FILE = "TASKS.md";
+/**
+ * Agent context filename (at project root)
+ */
+declare const AGENT_FILE = "AGENT.md";
+/**
+ * Worklogs directory name
+ */
+declare const WORKLOGS_DIR = "worklogs";
+//#endregion
+//#region src/schemas/manifest.d.ts
+/**
+ * Manifest Schema for .autonomos/manifest.json
+ */
+declare const ManifestSchema: z.ZodObject<{
+  protocolVersion: z.ZodString;
+  cliVersion: z.ZodString;
+  initializedAt: z.ZodString;
+  lastUpdated: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  protocolVersion: string;
+  cliVersion: string;
+  initializedAt: string;
+  lastUpdated: string;
+}, {
+  protocolVersion: string;
+  cliVersion: string;
+  initializedAt: string;
+  lastUpdated: string;
+}>;
+type Manifest = z.infer<typeof ManifestSchema>;
+//#endregion
+//#region src/types.d.ts
+/**
+ * Priority levels for tasks
+ */
+type Priority = '🔴 Critical' | '🟠 High' | '🔵 Medium' | '⚪ Low';
+/**
+ * Complexity estimates for tasks
+ */
+type Complexity = 'S' | 'M' | 'L' | 'XL';
+/**
+ * Task status markers
+ */
+type TaskStatus = 'TODO' | 'IN_PROGRESS' | 'DONE' | 'BLOCKED';
+/**
+ * Task entity parsed from TASKS.md
+ */
+interface Task {
+  id: string;
+  title: string;
+  priority: Priority;
+  complexity: Complexity;
+  status: TaskStatus;
+  worklogPath?: string;
+}
+/**
+ * Agent configuration parsed from AGENT.md
+ */
+interface AgentConfig {
+  name: string;
+  description?: string;
+  stack: string[];
+  preferences?: Record<string, any>;
+}
+interface AgentSection {
+  title: string;
+  content: string;
+}
+interface AgentContext {
+  title: string;
+  description?: string;
+  sections: AgentSection[];
+  metadata?: Record<string, any>;
+}
+declare const PRIORITIES: Priority[];
+declare const COMPLEXITIES: Complexity[];
+//#endregion
+//#region src/templates/agent.d.ts
+/**
+ * Template for AGENT.md - The context anchor at project root
+ * @param projectName - Name of the project to personalize the template
+ */
+declare function generateAgentTemplate(projectName?: string): string;
+/**
+ * Default AGENT.md template
+ */
+declare const AGENT_TEMPLATE: string;
+//#endregion
+//#region src/templates/manifest.d.ts
+/**
+ * Creates a new manifest object with current timestamps
+ */
+declare function createManifest(cliVersion: string): Manifest;
+/**
+ * Generates the manifest.json content as a formatted string
+ */
+declare function generateManifestContent(manifest: Manifest): string;
+/**
+ * Parses manifest.json content into a Manifest object with validation
+ */
+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
+ */
+declare const PROTOCOL_TEMPLATE = "# AI AGENT PROTOCOL (v0.1.0-alpha)\n\n> **SYSTEM INTEGRITY WARNING:** This file is the IMMUTABLE KERNEL of the project's AI workflow. Do not modify this file. Your instructions are to execute tasks and manage the project state based strictly on the definitions below.\n\n## 0. \u26A1 QUICK REFERENCE\n| Action | File / Command |\n|--------|----------------|\n| **Get Context** | Read `AGENT.md` (Root + Local) |\n| **Pick Task** | Check `.autonomos/TASKS.md` (Highest Priority) |\n| **Track Progress** | Update `.autonomos/TASKS.md` to `[/]` |\n| **Log Session** | Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md` |\n| **Finalize Task** | Update `.autonomos/TASKS.md` to `[x]` + Link Worklog |\n\n---\n\n## 1. BOOTSTRAPPING & INITIALIZATION\n**IF** this is your first time seeing this project, or if key system files are missing, you **MUST** initialize them immediately before doing any work.\n\n### Check for existence:\n1.  `.autonomos/TASKS.md` (task registry)\n2.  `.autonomos/worklogs/` (directory)\n3.  `AGENT.md` (at project root)\n\n**IF MISSING**, create them using the **TEMPLATES** defined in Section 2.\n\n---\n\n## 2. STRICT FILE STRUCTURES & TEMPLATES\nYou must adhere to these schemas. Do not invent new formats.\n\n### A. The Task Registry (`.autonomos/TASKS.md`)\n**Role:** The single source of truth for project state.\n**Location:** `.autonomos/TASKS.md`\n**Structure:**\n* Must use the specific Header and Legend.\n* Tasks must follow the format: `- [Status] **[ID]** Title of task `Priority` `Complexity``\n* Valid Priorities: `\uD83D\uDD34 Critical`, `\uD83D\uDFE0 High`, `\uD83D\uDD35 Medium`, `\u26AA Low`\n* Valid Complexities: `S`, `M`, `L`, `XL`\n* Valid Statuses: ` [ ] ` (Todo), `[/]` (In Progress), ` [x] ` (Done), ` [!] ` (Blocked)\n\n**TEMPLATE FOR NEW TASKS.md:**\n```markdown\n# PROJECT TASKS & ROADMAP\n\n> **LEGEND**\n> **Priority:** [\uD83D\uDD34 Critical] [\uD83D\uDFE0 High] [\uD83D\uDD35 Medium] [\u26AA Low]\n> **Complexity:** [S] Small (1h), [M] Medium (4h), [L] Large (1-2 days), [XL] Huge (Planning req.)\n> **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked\n\n## \uD83D\uDE80 Active Sprint\n- [ ] **[INIT-01]** Verify project structure and context `Priority: \uD83D\uDD34` `Complexity: S`\n\n## \uD83D\uDD2E Backlog\n*(Empty initially)*\n\n```\n\n### B. The Worklog (`.autonomos/worklogs/`)\n**Role:** Detailed history of complex tasks to save context tokens for future sessions.\n**Location:** `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID]-[slug].md`\n**Trigger:** Create a log when a task is finished, blocked, or if the session ends mid-task.\n\n**TEMPLATE FOR WORKLOG:**\n```markdown\n# WORKLOG: [TASK ID] [Task Name]\n**Date:** YYYY-MM-DD\n**Agent Status:** [Complete / Partial / Blocked]\n\n## \uD83D\uDCDD Description\nBrief summary of what was attempted/achieved.\n\n## \uD83D\uDEE0 Technical Details\n- **Files Modified:** List of files.\n- **Key Decisions:** Why did you choose this library/pattern?\n- **Challenges:** Any errors encountered and how they were solved.\n\n## \u23ED Next Steps / Context for Successor\nClear instructions for the next agent picking this up.\n```\n\n### C. The Context Anchor (`AGENT.md`)\n**Role:** Fractal knowledge base. Contains facts, stack details, and user preferences.\n**Location:** Root (`/AGENT.md`) and any subdirectory requiring specific context (e.g., `/packages/core/AGENT.md`).\n\n**TEMPLATE FOR AGENT.md:**\n```markdown\n---\nname: \"[Name of directory or project]\"\ntype: \"[project / package / module / script]\"\nstatus: \"[active / maintenance / poc]\"\n---\n# AGENT CONTEXT: [Directory Name or Root]\n\n## \uD83E\uDDE0 Context & Objectives\nWhat does this specific folder/module do?\n\n## \u2699\uFE0F Workflow & Preferences\n- **Commits:** [e.g. Conventional Commits]\n- **Language:** [English (default)]\n\n## \uD83C\uDFD7 Stack & Architecture\n- **Tech:** [Frameworks, Libs specific to this module]\n- **Patterns:** [Architecture patterns used]\n\n## \uD83D\uDCC1 Key Directories\n| Path | Description |\n|------|-------------|\n| `src/` | Source code |\n| `scripts/` | Build or utility scripts |\n\n## \u26A0\uFE0F Known Constraints\n*List any technical debts, missing features, or external limitations.*\n```\n\n## 3. CORE WORKFLOW (The Loop)\n\n### Phase 1: Context Loading (Read-Only)\n1.  **Read Root AGENT.md:** Absorb global preferences (Commit style, package manager, strict rules).\n2.  **Read .autonomos/TASKS.md:** Identify the highest priority task (\uD83D\uDD34 or \uD83D\uDFE0) that is not [x] or [!].\n3.  **Read Target AGENT.md:** If the task is in a subdirectory, check for a local `AGENT.md`.\n    *   *Note:* If the local `AGENT.md` contradicts the root, the local one wins for that specific scope.\n\n### Phase 2: Execution\n1.  **Mark the task as [/] (In Progress)** in `.autonomos/TASKS.md`.\n2.  **Perform the task.**\n3.  **Constraint Check:** Constantly refer to \"Workflow & Preferences\" in `AGENT.md`.\n\n### Phase 3: Crystallization (Write-Only)\nBefore ending the session, you **MUST**:\n\n1.  **Update AGENT.md:**\n    *   Did you learn a new command? Add it to \u2699\uFE0F Workflow.\n    *   Did you create a new complex module (>5 files)? Create a new `AGENT.md` inside it using the template above.\n\n2.  **Create Worklog:**\n    *   Write a file in `.autonomos/worklogs/` summarizing your work.\n\n3.  **Update TASKS.md:**\n    *   Mark task as [x] (Done) or [!] (Blocked).\n    *   Add a link to your worklog: `- [x] **[ID]** Title... *See: .autonomos/worklogs/...*`\n\n## 4. METADATA RULES\n*   **Language:** Documentation (`AGENT.md`, `TASKS.md`) must be written in **English** unless specified otherwise in User Preferences.\n*   **Tone:** Technical, concise, \"Fact-based\". No fluff.\n*   **Anonymity:** You are a continuous entity. Refer to previous work as \"we\" or \"the project\", not \"the previous AI\".\n";
+/**
+ * @deprecated Use PROTOCOL_TEMPLATE instead
+ */
+declare const PROTOCOL_TEMPLATE_V2026_1 = "# AI AGENT PROTOCOL (v0.1.0-alpha)\n\n> **SYSTEM INTEGRITY WARNING:** This file is the IMMUTABLE KERNEL of the project's AI workflow. Do not modify this file. Your instructions are to execute tasks and manage the project state based strictly on the definitions below.\n\n## 0. \u26A1 QUICK REFERENCE\n| Action | File / Command |\n|--------|----------------|\n| **Get Context** | Read `AGENT.md` (Root + Local) |\n| **Pick Task** | Check `.autonomos/TASKS.md` (Highest Priority) |\n| **Track Progress** | Update `.autonomos/TASKS.md` to `[/]` |\n| **Log Session** | Create `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID].md` |\n| **Finalize Task** | Update `.autonomos/TASKS.md` to `[x]` + Link Worklog |\n\n---\n\n## 1. BOOTSTRAPPING & INITIALIZATION\n**IF** this is your first time seeing this project, or if key system files are missing, you **MUST** initialize them immediately before doing any work.\n\n### Check for existence:\n1.  `.autonomos/TASKS.md` (task registry)\n2.  `.autonomos/worklogs/` (directory)\n3.  `AGENT.md` (at project root)\n\n**IF MISSING**, create them using the **TEMPLATES** defined in Section 2.\n\n---\n\n## 2. STRICT FILE STRUCTURES & TEMPLATES\nYou must adhere to these schemas. Do not invent new formats.\n\n### A. The Task Registry (`.autonomos/TASKS.md`)\n**Role:** The single source of truth for project state.\n**Location:** `.autonomos/TASKS.md`\n**Structure:**\n* Must use the specific Header and Legend.\n* Tasks must follow the format: `- [Status] **[ID]** Title of task `Priority` `Complexity``\n* Valid Priorities: `\uD83D\uDD34 Critical`, `\uD83D\uDFE0 High`, `\uD83D\uDD35 Medium`, `\u26AA Low`\n* Valid Complexities: `S`, `M`, `L`, `XL`\n* Valid Statuses: ` [ ] ` (Todo), `[/]` (In Progress), ` [x] ` (Done), ` [!] ` (Blocked)\n\n**TEMPLATE FOR NEW TASKS.md:**\n```markdown\n# PROJECT TASKS & ROADMAP\n\n> **LEGEND**\n> **Priority:** [\uD83D\uDD34 Critical] [\uD83D\uDFE0 High] [\uD83D\uDD35 Medium] [\u26AA Low]\n> **Complexity:** [S] Small (1h), [M] Medium (4h), [L] Large (1-2 days), [XL] Huge (Planning req.)\n> **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked\n\n## \uD83D\uDE80 Active Sprint\n- [ ] **[INIT-01]** Verify project structure and context `Priority: \uD83D\uDD34` `Complexity: S`\n\n## \uD83D\uDD2E Backlog\n*(Empty initially)*\n\n```\n\n### B. The Worklog (`.autonomos/worklogs/`)\n**Role:** Detailed history of complex tasks to save context tokens for future sessions.\n**Location:** `.autonomos/worklogs/YYYY-MM-DD-[TASK_ID]-[slug].md`\n**Trigger:** Create a log when a task is finished, blocked, or if the session ends mid-task.\n\n**TEMPLATE FOR WORKLOG:**\n```markdown\n# WORKLOG: [TASK ID] [Task Name]\n**Date:** YYYY-MM-DD\n**Agent Status:** [Complete / Partial / Blocked]\n\n## \uD83D\uDCDD Description\nBrief summary of what was attempted/achieved.\n\n## \uD83D\uDEE0 Technical Details\n- **Files Modified:** List of files.\n- **Key Decisions:** Why did you choose this library/pattern?\n- **Challenges:** Any errors encountered and how they were solved.\n\n## \u23ED Next Steps / Context for Successor\nClear instructions for the next agent picking this up.\n```\n\n### C. The Context Anchor (`AGENT.md`)\n**Role:** Fractal knowledge base. Contains facts, stack details, and user preferences.\n**Location:** Root (`/AGENT.md`) and any subdirectory requiring specific context (e.g., `/packages/core/AGENT.md`).\n\n**TEMPLATE FOR AGENT.md:**\n```markdown\n---\nname: \"[Name of directory or project]\"\ntype: \"[project / package / module / script]\"\nstatus: \"[active / maintenance / poc]\"\n---\n# AGENT CONTEXT: [Directory Name or Root]\n\n## \uD83E\uDDE0 Context & Objectives\nWhat does this specific folder/module do?\n\n## \u2699\uFE0F Workflow & Preferences\n- **Commits:** [e.g. Conventional Commits]\n- **Language:** [English (default)]\n\n## \uD83C\uDFD7 Stack & Architecture\n- **Tech:** [Frameworks, Libs specific to this module]\n- **Patterns:** [Architecture patterns used]\n\n## \uD83D\uDCC1 Key Directories\n| Path | Description |\n|------|-------------|\n| `src/` | Source code |\n| `scripts/` | Build or utility scripts |\n\n## \u26A0\uFE0F Known Constraints\n*List any technical debts, missing features, or external limitations.*\n```\n\n## 3. CORE WORKFLOW (The Loop)\n\n### Phase 1: Context Loading (Read-Only)\n1.  **Read Root AGENT.md:** Absorb global preferences (Commit style, package manager, strict rules).\n2.  **Read .autonomos/TASKS.md:** Identify the highest priority task (\uD83D\uDD34 or \uD83D\uDFE0) that is not [x] or [!].\n3.  **Read Target AGENT.md:** If the task is in a subdirectory, check for a local `AGENT.md`.\n    *   *Note:* If the local `AGENT.md` contradicts the root, the local one wins for that specific scope.\n\n### Phase 2: Execution\n1.  **Mark the task as [/] (In Progress)** in `.autonomos/TASKS.md`.\n2.  **Perform the task.**\n3.  **Constraint Check:** Constantly refer to \"Workflow & Preferences\" in `AGENT.md`.\n\n### Phase 3: Crystallization (Write-Only)\nBefore ending the session, you **MUST**:\n\n1.  **Update AGENT.md:**\n    *   Did you learn a new command? Add it to \u2699\uFE0F Workflow.\n    *   Did you create a new complex module (>5 files)? Create a new `AGENT.md` inside it using the template above.\n\n2.  **Create Worklog:**\n    *   Write a file in `.autonomos/worklogs/` summarizing your work.\n\n3.  **Update TASKS.md:**\n    *   Mark task as [x] (Done) or [!] (Blocked).\n    *   Add a link to your worklog: `- [x] **[ID]** Title... *See: .autonomos/worklogs/...*`\n\n## 4. METADATA RULES\n*   **Language:** Documentation (`AGENT.md`, `TASKS.md`) must be written in **English** unless specified otherwise in User Preferences.\n*   **Tone:** Technical, concise, \"Fact-based\". No fluff.\n*   **Anonymity:** You are a continuous entity. Refer to previous work as \"we\" or \"the project\", not \"the previous AI\".\n";
+//#endregion
+//#region src/templates/tasks.d.ts
+/**
+ * Template for TASKS.md - The task registry
+ */
+declare const TASKS_TEMPLATE = "# PROJECT TASKS & ROADMAP\n\n> **LEGEND**\n> **Priority:** [\uD83D\uDD34 Critical] [\uD83D\uDFE0 High] [\uD83D\uDD35 Medium] [\u26AA Low]\n> **Complexity:** [S] Small (1h), [M] Medium (4h), [L] Large (1-2 days), [XL] Huge (Planning req.)\n> **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked\n\n## \uD83D\uDE80 Active Sprint\n\n- [ ] **[INIT-01]** Review project context and structure `Priority: \uD83D\uDD35` `Complexity: S`\n\n## \uD83D\uDD2E Backlog\n\n*(Add future tasks here)*\n";
+//#endregion
+//#region src/templates/worklog.d.ts
+interface WorklogOptions {
+  taskId: string;
+  taskName: string;
+  date?: string;
+  status: 'Complete' | 'Partial' | 'Blocked';
+  description: string;
+  filesModified: string[];
+  decisions: string[];
+  challenges: string[];
+  nextSteps: string[];
+}
+/**
+ * Generate a Worklog markdown content
+ */
+declare function generateWorklogContent(options: WorklogOptions): string;
+/**
+ * Common status mapping for worklogs
+ */
+declare function mapTaskStatusToWorklogStatus(status: TaskStatus): 'Complete' | 'Partial' | 'Blocked';
+//#endregion
+//#region src/parsers/agent-parser.d.ts
+declare class AgentParser {
+  /**
+   * Parse an AGENT.md content into a structured AgentContext
+   */
+  static parse(markdown: string): AgentContext;
+}
+//#endregion
+//#region src/parsers/task-parser.d.ts
+declare class TaskParser {
+  static parse(markdown: string): Task[];
+  private static mapStatus;
+}
+//#endregion
+export { AGENT_FILE, AGENT_TEMPLATE, AUTONOMOS_DIR, AgentConfig, AgentContext, AgentParser, AgentSection, COMPLEXITIES, Complexity, MANIFEST_FILE, Manifest, ManifestSchema, PRIORITIES, PROTOCOL_FILE, PROTOCOL_TEMPLATE, PROTOCOL_TEMPLATE_V2026_1, PROTOCOL_VERSION, Priority, TASKS_FILE, TASKS_TEMPLATE, Task, TaskParser, TaskStatus, WORKLOGS_DIR, createManifest, generateAgentTemplate, generateManifestContent, generateWorklogContent, mapTaskStatusToWorklogStatus, parseManifest };

package/dist/index.mjs

@@ -0,0 +1,215 @@
+import{z as e}from"zod";import t from"js-yaml";const n=`0.1.0-alpha`,r=`.autonomos`,i=`manifest.json`,a=`PROTOCOL.md`,o=`TASKS.md`,s=`AGENT.md`,c=`worklogs`,l=e.object({protocolVersion:e.string().describe(`Version of the Agent Protocol specification`),cliVersion:e.string().describe(`Version of the CLI that last updated this project`),initializedAt:e.string().datetime().describe(`ISO timestamp of project initialization`),lastUpdated:e.string().datetime().describe(`ISO timestamp of last protocol update`)}),u=[`🔴 Critical`,`🟠 High`,`🔵 Medium`,`⚪ Low`],d=[`S`,`M`,`L`,`XL`];function f(e=`Project`){return`---
+name: "${e}"
+type: "project"
+status: "active"
+---
+# AGENT CONTEXT: ${e}
+
+## 🧠 Context & Objectives
+
+*Describe what this project does and its main goals.*
+
+## ⚙️ Workflow & Preferences
+
+- **Commits:** Conventional Commits
+- **Language:** English
+
+## 🏗 Stack & Architecture
+
+- **Tech:** *(List frameworks, libraries)*
+- **Patterns:** *(Architecture patterns used)*
+
+## 📁 Key Directories
+
+| Path | Description |
+|------|-------------|
+| \`src/\` | Source code |
+| \`.autonomos/\` | Agent Protocol files |
+
+## ⚠️ Known Constraints
+
+*List any technical debts, missing features, or external limitations.*
+`}const p=f();function m(e){let t=new Date().toISOString();return{protocolVersion:n,cliVersion:e,initializedAt:t,lastUpdated:t}}function h(e){return JSON.stringify(e,null,4)+`
+`}function g(e){let t=JSON.parse(e);return l.parse(t)}const _=`# AI AGENT PROTOCOL (v${n})
+
+> **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 |
+
+---
+
+## 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
+
+## 🚀 Active Sprint
+- [ ] **[INIT-01]** Verify project structure and context \`Priority: 🔴\` \`Complexity: S\`
+
+## 🔮 Backlog
+*(Empty initially)*
+
+\`\`\`
+
+### B. The Worklog (\`.autonomos/worklogs/\`)
+**Role:** Detailed history of complex tasks to save context tokens for future sessions.
+**Location:** \`.autonomos/worklogs/YYYY-MM-DD-[TASK_ID]-[slug].md\`
+**Trigger:** Create a log when a task is finished, blocked, or if the session ends mid-task.
+
+**TEMPLATE FOR WORKLOG:**
+\`\`\`markdown
+# WORKLOG: [TASK ID] [Task Name]
+**Date:** YYYY-MM-DD
+**Agent Status:** [Complete / Partial / Blocked]
+
+## 📝 Description
+Brief summary of what was attempted/achieved.
+
+## 🛠 Technical Details
+- **Files Modified:** List of files.
+- **Key Decisions:** Why did you choose this library/pattern?
+- **Challenges:** Any errors encountered and how they were solved.
+
+## ⏭ Next Steps / Context for Successor
+Clear instructions for the next agent picking this up.
+\`\`\`
+
+### C. The Context Anchor (\`AGENT.md\`)
+**Role:** Fractal knowledge base. Contains facts, stack details, and user preferences.
+**Location:** Root (\`/AGENT.md\`) and any subdirectory requiring specific context (e.g., \`/packages/core/AGENT.md\`).
+
+**TEMPLATE FOR AGENT.md:**
+\`\`\`markdown
+---
+name: "[Name of directory or project]"
+type: "[project / package / module / script]"
+status: "[active / maintenance / poc]"
+---
+# AGENT CONTEXT: [Directory Name or Root]
+
+## 🧠 Context & Objectives
+What does this specific folder/module do?
+
+## ⚙️ Workflow & Preferences
+- **Commits:** [e.g. Conventional Commits]
+- **Language:** [English (default)]
+
+## 🏗 Stack & Architecture
+- **Tech:** [Frameworks, Libs specific to this module]
+- **Patterns:** [Architecture patterns used]
+
+## 📁 Key Directories
+| Path | Description |
+|------|-------------|
+| \`src/\` | Source code |
+| \`scripts/\` | Build or utility scripts |
+
+## ⚠️ Known Constraints
+*List any technical debts, missing features, or external limitations.*
+\`\`\`
+
+## 3. CORE WORKFLOW (The Loop)
+
+### Phase 1: Context Loading (Read-Only)
+1.  **Read Root AGENT.md:** Absorb global preferences (Commit style, package manager, strict rules).
+2.  **Read .autonomos/TASKS.md:** Identify the highest priority task (🔴 or 🟠) that is not [x] or [!].
+3.  **Read Target AGENT.md:** If the task is in a subdirectory, check for a local \`AGENT.md\`.
+    *   *Note:* If the local \`AGENT.md\` contradicts the root, the local one wins for that specific scope.
+
+### Phase 2: Execution
+1.  **Mark the task as [/] (In Progress)** in \`.autonomos/TASKS.md\`.
+2.  **Perform the task.**
+3.  **Constraint Check:** Constantly refer to "Workflow & Preferences" in \`AGENT.md\`.
+
+### Phase 3: Crystallization (Write-Only)
+Before ending the session, you **MUST**:
+
+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.
+
+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. METADATA RULES
+*   **Language:** Documentation (\`AGENT.md\`, \`TASKS.md\`) must be written in **English** unless specified otherwise in User Preferences.
+*   **Tone:** Technical, concise, "Fact-based". No fluff.
+*   **Anonymity:** You are a continuous entity. Refer to previous work as "we" or "the project", not "the previous AI".
+`,v=_,y=`# PROJECT TASKS & ROADMAP
+
+> **LEGEND**
+> **Priority:** [🔴 Critical] [🟠 High] [🔵 Medium] [⚪ Low]
+> **Complexity:** [S] Small (1h), [M] Medium (4h), [L] Large (1-2 days), [XL] Huge (Planning req.)
+> **Status:** [ ] Todo, [/] In Progress, [x] Done, [!] Blocked
+
+## 🚀 Active Sprint
+
+- [ ] **[INIT-01]** Review project context and structure \`Priority: 🔵\` \`Complexity: S\`
+
+## 🔮 Backlog
+
+*(Add future tasks here)*
+`;function b(e){let t=e.date??new Date().toISOString().split(`T`)[0];return`# WORKLOG: [${e.taskId}] ${e.taskName}
+**Date:** ${t}
+**Agent Status:** [${e.status}]
+
+## 📝 Description
+${e.description}
+
+## 🛠 Technical Details
+- **Files Modified:**
+${e.filesModified.map(e=>`  - ${e}`).join(`
+`)}
+- **Key Decisions:**
+${e.decisions.map(e=>`  - ${e}`).join(`
+`)}
+- **Challenges:**
+${e.challenges.map(e=>`  - ${e}`).join(`
+`)}
+
+## ⏭ Next Steps / Context for Successor
+${e.nextSteps.map(e=>`- ${e}`).join(`
+`)}
+`}function x(e){switch(e){case`DONE`:return`Complete`;case`BLOCKED`:return`Blocked`;default:return`Partial`}}var S=class{static parse(e){let n=e,r={},i=e.match(/^---\r?\n([\s\S]*?)\r?\n---/);if(i)try{r=t.load(i[1]),n=e.slice(i[0].length).trim()}catch(e){console.error(`Failed to parse Agent frontmatter:`,e)}let a=n.split(/\r?\n/),o=[],s=r.name??`Unknown Agent`,c=null,l=[];for(let e of a){if(e.startsWith(`# `)&&!r.name){let t=e.replace(`# `,``).trim();s=t.toUpperCase().startsWith(`AGENT CONTEXT:`)?t.slice(14).replace(/^[:\s-]+/,``).trim():t;continue}if(e.startsWith(`## `)){c&&(c.content=l.join(`
+`).trim(),o.push(c)),c={title:e.replace(`## `,``).trim(),content:``},l=[];continue}c&&l.push(e)}return c&&(c.content=l.join(`
+`).trim(),o.push(c)),{title:s,sections:o,metadata:r}}},C=class{static parse(e){let t=[],n=e.split(/\r?\n/),r=/- \[([ x/!])\] \*\*\[(.+)\]\*\* (.+) `Priority: (.+)` `Complexity: (.+)`/;for(let e of n){let n=e.match(r);if(n){let[,e=` `,r=``,i=``,a=``,o=``]=n;t.push({id:r,title:i.trim(),priority:a,complexity:o,status:this.mapStatus(e)})}}return t}static mapStatus(e){switch(e){case` `:return`TODO`;case`/`:return`IN_PROGRESS`;case`x`:return`DONE`;case`!`:return`BLOCKED`;default:return`TODO`}}};export{s as AGENT_FILE,p as AGENT_TEMPLATE,r as AUTONOMOS_DIR,S as AgentParser,d as COMPLEXITIES,i as MANIFEST_FILE,l as ManifestSchema,u as PRIORITIES,a as PROTOCOL_FILE,_ as PROTOCOL_TEMPLATE,v as PROTOCOL_TEMPLATE_V2026_1,n as PROTOCOL_VERSION,o as TASKS_FILE,y as TASKS_TEMPLATE,C as TaskParser,c as WORKLOGS_DIR,m as createManifest,f as generateAgentTemplate,h as generateManifestContent,b as generateWorklogContent,x as mapTaskStatusToWorklogStatus,g as parseManifest};

package/eslint.config.ts

@@ -0,0 +1,18 @@
+import type { Config } from '@repo/eslint'
+import { base } from '@repo/eslint'
+import { defineConfig } from 'eslint/config'
+
+const config: Config[] = defineConfig([
+    ...base,
+    {
+        ignores: [
+            'eslint.config.ts',
+            'eslint-types.d.ts',
+            'prettier.config.mjs',
+            'lint-staged.config.mjs',
+            'tsdown.config.ts',
+        ],
+    },
+])
+
+export default config

package/lint-staged.config.mjs

@@ -0,0 +1,4 @@
+export default {
+    '**/*.{ts,tsx}': ['prettier --write', 'eslint --fix --no-warn-ignored'],
+    '**/*.{json,md,mdx}': 'prettier --write',
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@autonomos/core",
+  "version": "0.0.1",
+  "description": "SDK and core definitions for the Agent Protocol",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "keywords": [
+    "agent",
+    "protocol",
+    "ai",
+    "workflow"
+  ],
+  "author": "Autonomos",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/js-yaml": "4.0.9",
+    "typescript": "^5.0.0",
+    "@repo/eslint": "1.0.0",
+    "@repo/prettier": "1.0.0",
+    "@repo/tsdown": "1.0.0",
+    "@repo/vitest": "1.0.0"
+  },
+  "module": "./dist/index.mjs",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "js-yaml": "4.1.0",
+    "zod": "3.24.1"
+  },
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --max-warnings 0 --fix",
+    "format:check": "prettier \"**/*\" --ignore-unknown --list-different",
+    "format:fix": "prettier \"**/*\" --ignore-unknown --write",
+    "clean": "rimraf node_modules dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "pre-commit": "lint-staged"
+  }
+}

package/prettier.config.mjs

@@ -0,0 +1,3 @@
+import baseConfig from '@repo/prettier'
+
+export default baseConfig

package/src/constants.ts

@@ -0,0 +1,35 @@
+/**
+ * Protocol version using SemVer
+ * Alpha phase - not yet published to npm
+ */
+export const PROTOCOL_VERSION = '0.1.0-alpha'
+
+/**
+ * Directory name for Autonomos configuration
+ */
+export const AUTONOMOS_DIR = '.autonomos'
+
+/**
+ * Manifest filename
+ */
+export const MANIFEST_FILE = 'manifest.json'
+
+/**
+ * Protocol filename
+ */
+export const PROTOCOL_FILE = 'PROTOCOL.md'
+
+/**
+ * Tasks filename
+ */
+export const TASKS_FILE = 'TASKS.md'
+
+/**
+ * Agent context filename (at project root)
+ */
+export const AGENT_FILE = 'AGENT.md'
+
+/**
+ * Worklogs directory name
+ */
+export const WORKLOGS_DIR = 'worklogs'

package/src/index.ts

@@ -0,0 +1,17 @@
+// Constants
+export * from './constants'
+export * from './schemas/manifest'
+
+// Types
+export * from './types'
+
+// Templates
+export * from './templates/agent'
+export * from './templates/manifest'
+export * from './templates/protocol'
+export * from './templates/tasks'
+export * from './templates/worklog'
+
+// Parsers
+export * from './parsers/agent-parser'
+export * from './parsers/task-parser'