@autonomos/core 0.0.1 → 0.1.0

package/src/templates/protocol.ts

@@ -1,157 +0,0 @@
-import { PROTOCOL_VERSION } from '../constants'
-
-/**
- * The immutable Protocol kernel template
- * This is the core specification that defines how AI agents interact with the project
- */
-export const PROTOCOL_TEMPLATE = `# AI AGENT PROTOCOL (v${PROTOCOL_VERSION})
-
-> **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".
-`
-
-/**
- * @deprecated Use PROTOCOL_TEMPLATE instead
- */
-export const PROTOCOL_TEMPLATE_V2026_1 = PROTOCOL_TEMPLATE

package/src/templates/tasks.ts

@@ -1,18 +0,0 @@
-/**
- * Template for TASKS.md - The task registry
- */
-export const TASKS_TEMPLATE = `# 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)*
-`

package/src/templates/worklog.test.ts

@@ -1,37 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import { generateWorklogContent } from './worklog'
-
-describe('Worklog Template', () => {
-    it('should generate a valid worklog content', () => {
-        const content = generateWorklogContent({
-            taskId: 'TASK-01',
-            taskName: 'Fixing Bug',
-            status: 'Complete',
-            description: 'Fixed the line splitting issue.',
-            filesModified: ['src/parsers/task-parser.ts'],
-            decisions: ['Used regex for splitting'],
-            challenges: ['Template literal escaping'],
-            nextSteps: ['Add more tests'],
-        })
-
-        expect(content).toContain('# WORKLOG: [TASK-01] Fixing Bug')
-        expect(content).toContain('**Agent Status:** [Complete]')
-        expect(content).toContain('- src/parsers/task-parser.ts')
-        expect(content).toContain('- Used regex for splitting')
-    })
-
-    it('should use current date if not provided', () => {
-        const content = generateWorklogContent({
-            taskId: 'T',
-            taskName: 'N',
-            status: 'Partial',
-            description: 'D',
-            filesModified: [],
-            decisions: [],
-            challenges: [],
-            nextSteps: [],
-        })
-        const today = new Date().toISOString().split('T')[0]
-        expect(content).toContain(`**Date:** ${today}`)
-    })
-})

package/src/templates/worklog.ts

@@ -1,55 +0,0 @@
-import type { TaskStatus } from '../types'
-
-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
- */
-export function generateWorklogContent(options: WorklogOptions): string {
-    const date = options.date ?? new Date().toISOString().split('T')[0]
-
-    return `# WORKLOG: [${options.taskId}] ${options.taskName}
-**Date:** ${date}
-**Agent Status:** [${options.status}]
-
-## 📝 Description
-${options.description}
-
-## 🛠 Technical Details
-- **Files Modified:**
-${options.filesModified.map(f => `  - ${f}`).join('\n')}
-- **Key Decisions:**
-${options.decisions.map(d => `  - ${d}`).join('\n')}
-- **Challenges:**
-${options.challenges.map(c => `  - ${c}`).join('\n')}
-
-## ⏭ Next Steps / Context for Successor
-${options.nextSteps.map(s => `- ${s}`).join('\n')}
-`
-}
-
-/**
- * Common status mapping for worklogs
- */
-export function mapTaskStatusToWorklogStatus(
-    status: TaskStatus
-): 'Complete' | 'Partial' | 'Blocked' {
-    switch (status) {
-        case 'DONE':
-            return 'Complete'
-        case 'BLOCKED':
-            return 'Blocked'
-        default:
-            return 'Partial'
-    }
-}

package/src/types.ts

@@ -1,51 +0,0 @@
-/**
- * Priority levels for tasks
- */
-export type Priority = '🔴 Critical' | '🟠 High' | '🔵 Medium' | '⚪ Low'
-
-/**
- * Complexity estimates for tasks
- */
-export type Complexity = 'S' | 'M' | 'L' | 'XL'
-
-/**
- * Task status markers
- */
-export type TaskStatus = 'TODO' | 'IN_PROGRESS' | 'DONE' | 'BLOCKED'
-
-/**
- * Task entity parsed from TASKS.md
- */
-export interface Task {
-    id: string
-    title: string
-    priority: Priority
-    complexity: Complexity
-    status: TaskStatus
-    worklogPath?: string
-}
-
-/**
- * Agent configuration parsed from AGENT.md
- */
-export interface AgentConfig {
-    name: string
-    description?: string
-    stack: string[]
-    preferences?: Record<string, any>
-}
-
-export interface AgentSection {
-    title: string
-    content: string
-}
-
-export interface AgentContext {
-    title: string
-    description?: string
-    sections: AgentSection[]
-    metadata?: Record<string, any>
-}
-
-export const PRIORITIES: Priority[] = ['🔴 Critical', '🟠 High', '🔵 Medium', '⚪ Low']
-export const COMPLEXITIES: Complexity[] = ['S', 'M', 'L', 'XL']

package/tsconfig.json

@@ -1,36 +0,0 @@
-{
-    "extends": "@repo/tsconfig/base.json",
-    "compilerOptions": {
-        "target": "esnext",
-        "lib": ["es2022"],
-        "moduleDetection": "force",
-        "module": "esnext",
-        "moduleResolution": "bundler",
-        "resolveJsonModule": true,
-        "types": ["node", "vitest"],
-        "strict": true,
-        "noUnusedLocals": true,
-        "declaration": true,
-        "esModuleInterop": true,
-        "isolatedModules": true,
-        "verbatimModuleSyntax": true,
-        "skipLibCheck": true,
-        "baseUrl": ".",
-        "outDir": "./dist",
-        "rootDir": ".",
-        "paths": {
-            "@/*": ["src/*"],
-            "@tests/*": ["tests/*"]
-        }
-    },
-    "include": [
-        "./src/**/*",
-        "./src/**/*.json",
-        "tsdown.config.ts",
-        "vitest.config.ts",
-        "tests/**/*",
-        "lint-staged.config.mjs",
-        "prettier.config.mjs"
-    ],
-    "exclude": ["dist", "build", "node_modules", ".vscode", ".turbo", "coverage"]
-}

package/tsdown.config.ts

@@ -1,10 +0,0 @@
-import { base } from '@repo/tsdown'
-import type { UserConfigFn } from 'tsdown/config'
-import { defineConfig } from 'tsdown/config'
-
-const configFn: UserConfigFn = defineConfig(async options => ({
-    ...(await base(options, { ci: true })),
-    entry: ['./src/index.ts', './src/*/index.ts'],
-}))
-
-export default configFn

package/vitest.config.ts

@@ -1,9 +0,0 @@
-import { base } from '@repo/vitest'
-import type { ViteUserConfig } from 'vitest/config'
-import { defineConfig } from 'vitest/config'
-
-const config: ViteUserConfig = defineConfig({
-    ...base,
-})
-
-export default config