cognitive-core 0.2.4 → 0.3.1

package/dist/workspace/templates/usage-inference.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-inference.js","sourceRoot":"","sources":["../../../src/workspace/templates/usage-inference.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usage-inference.js","sourceRoot":"","sources":["../../../src/workspace/templates/usage-inference.ts"],"names":[],"mappings":"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"}

package/dist/workspace/types.d.ts

@@ -2,8 +2,8 @@ import type { TaskTemplate, TaskComplexity, SkillSpec, ResourceSpec as BaseResou
 import type { MemorySystem, MemoryQueryResultV2 } from '../memory/system.js';
 import type { Trajectory } from '../types/index.js';
 import type { ComputeRequirements } from '../runtime/compute-provider.js';
-export type { WorkspaceHandle, OutputSpec, OutputFileSpec, ValidationResult } from 'agent-workspace';
-export type { TaskTemplate, TaskComplexity, SkillSpec, TaskRunner, TaskResult, AgentBackend, AgentSpawnConfig, AgentResult, TaskRunnerHooks, TaskRunnerConfig } from 'agent-workspace';
+export type { WorkspaceHandle, OutputSpec, OutputFileSpec, ValidationResult, } from 'agent-workspace';
+export type { TaskTemplate, TaskComplexity, SkillSpec, TaskRunner, TaskResult, AgentBackend, AgentSpawnConfig, AgentResult, TaskRunnerHooks, TaskRunnerConfig, } from 'agent-workspace';
 /**
  * Skill to load into workspace skills/ directory.
  * Extends agent-workspace's SkillSpec with source tracking.
@@ -67,6 +67,8 @@ export interface AgenticTaskTemplate<TInput, TOutput> extends TaskTemplate<TInpu
     processOutput(output: TOutput, input: TInput, context: ProcessingContext): Promise<void>;
     /** Whether to capture detailed tool calls (default: true) */
     captureToolCalls?: boolean;
+    /** Stable prompt/template version for provenance and audit traces. */
+    templateVersion?: string;
     /**
      * Static compute requirements for this template.
      * Used by ComputeProvider to select appropriate backend.
@@ -86,8 +88,16 @@ export interface AgenticTaskResult<TOutput> {
     output: TOutput;
     /** Whether heuristic or agentic path was used */
     method: 'heuristic' | 'agentic';
+    /** Complexity tier used for this run. */
+    complexity?: AnalysisComplexity;
+    /** Workspace id used by the analysis agent, if any. */
+    workspaceId?: string;
+    /** Workspace path used by the analysis agent, if any. */
+    workspacePath?: string;
     /** Trajectory ID of the analysis agent (if agentic) */
     agentTrajectoryId?: string;
+    /** Meta-playbook IDs injected to guide this analysis task (Phase 0 join key). */
+    injectedMetaPlaybookIds?: string[];
     /** Execution metrics */
     metrics: AgenticTaskMetrics;
 }
@@ -105,6 +115,26 @@ export interface AgenticTaskMetrics {
 export declare class AgenticTaskOutputError extends Error {
     readonly taskType: string;
     readonly cause: Error;
+    complexity?: AnalysisComplexity;
+    workspaceId?: string;
+    workspacePath?: string;
+    elapsedMs?: number;
+    agentState?: string;
+    agentResultPreview?: string;
+    agentMessageCount?: number;
     constructor(taskType: string, cause: Error);
 }
+/**
+ * Error thrown when a workspace-backed agentic task fails before producing
+ * validated output. Carries the retained workspace path for post-run debugging.
+ */
+export declare class AgenticTaskRunError extends Error {
+    readonly taskType: string;
+    readonly complexity: AnalysisComplexity;
+    readonly workspaceId: string;
+    readonly workspacePath: string;
+    readonly elapsedMs: number;
+    readonly cause: Error;
+    constructor(taskType: string, complexity: AnalysisComplexity, workspaceId: string, workspacePath: string, elapsedMs: number, cause: Error);
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/workspace/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"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"}

package/dist/workspace/types.js

@@ -7,6 +7,13 @@
 export class AgenticTaskOutputError extends Error {
     taskType;
     cause;
+    complexity;
+    workspaceId;
+    workspacePath;
+    elapsedMs;
+    agentState;
+    agentResultPreview;
+    agentMessageCount;
     constructor(taskType, cause) {
         super(`Agentic task '${taskType}' output validation failed: ${cause.message}`);
         this.taskType = taskType;
@@ -14,4 +21,26 @@ export class AgenticTaskOutputError extends Error {
         this.name = 'AgenticTaskOutputError';
     }
 }
+/**
+ * Error thrown when a workspace-backed agentic task fails before producing
+ * validated output. Carries the retained workspace path for post-run debugging.
+ */
+export class AgenticTaskRunError extends Error {
+    taskType;
+    complexity;
+    workspaceId;
+    workspacePath;
+    elapsedMs;
+    cause;
+    constructor(taskType, complexity, workspaceId, workspacePath, elapsedMs, cause) {
+        super(`Agentic task '${taskType}' failed after ${elapsedMs}ms: ${cause.message}`);
+        this.taskType = taskType;
+        this.complexity = complexity;
+        this.workspaceId = workspaceId;
+        this.workspacePath = workspacePath;
+        this.elapsedMs = elapsedMs;
+        this.cause = cause;
+        this.name = 'AgenticTaskRunError';
+    }
+}
 //# sourceMappingURL=types.js.map

package/dist/workspace/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAyKA,+DAA+D;AAC/D,SAAS;AACT,+DAA+D;AAE/D;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAE7B;IACA;IAFlB,YACkB,QAAgB,EAChB,KAAY;QAE5B,KAAK,CAAC,iBAAiB,QAAQ,+BAA+B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAH/D,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAO;QAG5B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AA0LA,+DAA+D;AAC/D,SAAS;AACT,+DAA+D;AAE/D;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAU7B;IACA;IAVlB,UAAU,CAAsB;IAChC,WAAW,CAAU;IACrB,aAAa,CAAU;IACvB,SAAS,CAAU;IACnB,UAAU,CAAU;IACpB,kBAAkB,CAAU;IAC5B,iBAAiB,CAAU;IAE3B,YACkB,QAAgB,EAChB,KAAY;QAE5B,KAAK,CAAC,iBAAiB,QAAQ,+BAA+B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAH/D,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAO;QAG5B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAE1B;IACA;IACA;IACA;IACA;IACA;IANlB,YACkB,QAAgB,EAChB,UAA8B,EAC9B,WAAmB,EACnB,aAAqB,EACrB,SAAiB,EACjB,KAAY;QAE5B,KAAK,CAAC,iBAAiB,QAAQ,kBAAkB,SAAS,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAPlE,aAAQ,GAAR,QAAQ,CAAQ;QAChB,eAAU,GAAV,UAAU,CAAoB;QAC9B,gBAAW,GAAX,WAAW,CAAQ;QACnB,kBAAa,GAAb,aAAa,CAAQ;QACrB,cAAS,GAAT,SAAS,CAAQ;QACjB,UAAK,GAAL,KAAK,CAAO;QAG5B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cognitive-core",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "description": "TypeScript-native cognitive core for adaptive learning and abstraction",
   "type": "module",
   "main": "dist/index.js",
@@ -9,36 +9,40 @@
     "cognitive-core": "./dist/bin/cognitive-core.js",
     "cogcore": "./dist/bin/cognitive-core.js"
   },
+  "files": [
+    "dist",
+    "playbooks"
+  ],
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "default": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     },
     "./memory": {
+      "types": "./dist/memory/index.d.ts",
       "import": "./dist/memory/index.js",
-      "default": "./dist/memory/index.js",
-      "types": "./dist/memory/index.d.ts"
+      "default": "./dist/memory/index.js"
     },
     "./learning": {
+      "types": "./dist/learning/index.d.ts",
       "import": "./dist/learning/index.js",
-      "default": "./dist/learning/index.js",
-      "types": "./dist/learning/index.d.ts"
+      "default": "./dist/learning/index.js"
     },
     "./agents": {
+      "types": "./dist/agents/index.d.ts",
       "import": "./dist/agents/index.js",
-      "default": "./dist/agents/index.js",
-      "types": "./dist/agents/index.d.ts"
+      "default": "./dist/agents/index.js"
     },
     "./embeddings": {
+      "types": "./dist/embeddings/index.d.ts",
       "import": "./dist/embeddings/index.js",
-      "default": "./dist/embeddings/index.js",
-      "types": "./dist/embeddings/index.d.ts"
+      "default": "./dist/embeddings/index.js"
     },
     "./session-bank": {
+      "types": "./dist/session-bank/index.d.ts",
       "import": "./dist/session-bank/index.js",
-      "default": "./dist/session-bank/index.js",
-      "types": "./dist/session-bank/index.d.ts"
+      "default": "./dist/session-bank/index.js"
     }
   },
   "scripts": {
@@ -48,10 +52,21 @@
     "test:run": "vitest run",
     "lint": "eslint src --ext .ts",
     "typecheck": "tsc --noEmit",
+    "depcruise": "depcruise src --config .dependency-cruiser.cjs",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "check": "npm run typecheck && npm run lint && npm run depcruise && npm run format:check && npm run test:coverage",
+    "eval": "tsc && node dist/bin/cognitive-core.js eval",
+    "eval:ablation": "tsc && node dist/bin/cognitive-core.js eval ablation",
+    "eval:live": "tsc && node dist/bin/cognitive-core.js eval --backend live --benchmark gsm8k",
+    "test:live:extraction": "RUN_LIVE_EXTRACTION=1 vitest run tests/eval/playbook-extraction-live.test.ts",
+    "test:live:solve": "RUN_LIVE_SOLVE=1 vitest run tests/eval/solve-import-live.test.ts",
     "version:patch": "npm version patch && git push && git push --tags",
     "version:minor": "npm version minor && git push && git push --tags",
     "version:major": "npm version major && git push && git push --tags",
-    "publish:npm": "npm run build && npm publish"
+    "prepublishOnly": "npm run build && publint",
+    "publish:npm": "npm run build && npm publish",
+    "test:coverage": "vitest run --coverage tests/memory tests/learning tests/search tests/runtime tests/embeddings tests/agents tests/utils tests/types tests/persistence"
   },
   "keywords": [
     "cognitive",
@@ -67,23 +82,32 @@
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "@vitest/coverage-v8": "^1.6.1",
+    "dependency-cruiser": "^18.0.0",
+    "e2b": "^2.30.5",
     "eslint": "^8.55.0",
+    "prettier": "^3.9.4",
+    "publint": "^0.3.21",
+    "swarmkit-eval": "file:../swarmkit/src/eval",
     "typescript": "^5.3.0",
     "vitest": "^1.0.0"
   },
   "dependencies": {
-    "acp-factory": "^0.1.14",
+    "acp-factory": "^0.1.15",
     "agent-workspace": "^0.1.5",
     "better-sqlite3": "^12.0.0",
-    "minimem": "^0.1.0",
-    "sessionlog": "^0.0.4",
-    "skill-tree": "^0.1.5",
+    "chokidar": "^4.0.3",
+    "minimem": "^0.1.2",
+    "sessionlog": "^0.1.0",
+    "skill-tree": "^0.3.1",
     "sqlite-vec": "^0.1.6",
     "yaml": "^2.8.2",
     "zod": "^3.22.0"
   },
   "peerDependencies": {
-    "@huggingface/transformers": "^3.0.0"
+    "@huggingface/transformers": "^3.8.1"
   },
   "peerDependenciesMeta": {
     "@huggingface/transformers": {

package/playbooks/agent-ops/long-task-checkpointing.json

@@ -0,0 +1,54 @@
+{
+  "name": "long-task-checkpointing",
+  "curatedBy": "cognitive-core",
+  "confidence": 0.7,
+  "complexity": "moderate",
+  "estimatedEffort": 3,
+  "applicability": {
+    "situations": [
+      "Executing a long multi-step task where context or session limits may interrupt work",
+      "Coordinating work that another agent or a later session must be able to resume",
+      "Accumulating findings across many files or commands that exceed working memory"
+    ],
+    "triggers": [
+      "long-running task",
+      "multi-step plan",
+      "resume work",
+      "context getting large",
+      "handoff"
+    ],
+    "antiPatterns": [
+      "Do not checkpoint trivial single-step tasks — the overhead exceeds the benefit",
+      "Do not let checkpoint files become the work product; they are scaffolding, cleaned up at the end",
+      "Do not duplicate state the environment already tracks durably (e.g. git history, task tracker)"
+    ],
+    "domains": ["agent-execution", "planning"]
+  },
+  "guidance": {
+    "strategy": "Externalize state early: keep a durable plan with per-step status, record decisions and their reasons when made, and structure the work so any interruption loses at most one step. Assume the session can end at any moment and the resumer knows nothing you did not write down.",
+    "tactics": [
+      "Maintain an explicit task list with statuses (pending / in-progress / done) and update it as you go, not retroactively",
+      "Record non-obvious decisions and dead ends when they happen — they are the most expensive things to rediscover",
+      "Prefer many small verifiable increments over one large batch; each increment should leave the workspace consistent",
+      "Write intermediate findings (measurements, file lists, error catalogs) to files instead of holding them in context",
+      "On resume, first re-verify the recorded state against reality (files, git status) before continuing the plan"
+    ],
+    "steps": [
+      "1. Break the task into increments that each leave a consistent, verifiable state",
+      "2. Record the plan durably with per-increment status",
+      "3. After each increment: verify, update status, note any decisions made",
+      "4. On interruption/resume: reconcile recorded state with actual workspace state, then continue"
+    ]
+  },
+  "verification": {
+    "successIndicators": [
+      "An interrupted run can be resumed from the recorded state without re-deriving prior work",
+      "Decisions and dead ends are discoverable in the record, not just in lost context"
+    ],
+    "failureIndicators": [
+      "Interruption forces restarting the task from scratch",
+      "Plan status diverges from actual workspace state",
+      "The same dead end is explored twice"
+    ]
+  }
+}

package/playbooks/agent-ops/progressive-context-gathering.json

@@ -0,0 +1,56 @@
+{
+  "name": "progressive-context-gathering",
+  "curatedBy": "cognitive-core",
+  "confidence": 0.75,
+  "complexity": "simple",
+  "estimatedEffort": 2,
+  "applicability": {
+    "situations": [
+      "Starting work in an unfamiliar codebase or module",
+      "About to edit a file that has not been read in this session",
+      "Forming a hypothesis about how existing code behaves"
+    ],
+    "triggers": [
+      "unfamiliar codebase",
+      "before editing",
+      "how does this work",
+      "find the implementation",
+      "locate the code"
+    ],
+    "antiPatterns": [
+      "Do not exhaustively read the whole repository before acting — gather context proportional to the task",
+      "Do not re-read files already read and unchanged in this session",
+      "Do not apply when the task spec already contains all needed context (e.g. a self-contained snippet fix)"
+    ],
+    "domains": ["agent-execution", "investigation", "software-engineering"]
+  },
+  "guidance": {
+    "strategy": "Read before you write and search before you assume. Build understanding outside-in — structure first, then the specific files the task touches — and batch independent lookups instead of issuing them one at a time.",
+    "tactics": [
+      "Always read a file before editing it; edits based on guessed content produce broken patches",
+      "Search for existing implementations, helpers, and conventions before writing new code — most codebases already contain the pattern you need",
+      "Batch independent searches and reads in parallel; serialize only when one result determines the next query",
+      "Prefer targeted search (symbol names, error strings, route paths) over browsing directory trees",
+      "When behavior is unclear, prefer running the code or its tests over speculating from source alone",
+      "Stop gathering when you can state what you will change and why — context gathering past that point is procrastination"
+    ],
+    "steps": [
+      "1. Identify what the task actually requires knowing (files, conventions, invariants)",
+      "2. Locate entry points via targeted search rather than directory browsing",
+      "3. Read the files you will modify plus their immediate callers/tests",
+      "4. Confirm conventions (naming, error handling, test style) from neighboring code",
+      "5. Act once you can articulate the change; return for more context only when surprised"
+    ]
+  },
+  "verification": {
+    "successIndicators": [
+      "Edits match existing file content and conventions on the first attempt",
+      "Existing helpers are reused instead of reimplemented"
+    ],
+    "failureIndicators": [
+      "Patches fail to apply because file content was assumed",
+      "New code duplicates an existing utility",
+      "Long exploration with no resulting action"
+    ]
+  }
+}

package/playbooks/agent-ops/safe-destructive-operations.json

@@ -0,0 +1,59 @@
+{
+  "name": "safe-destructive-operations",
+  "curatedBy": "cognitive-core",
+  "confidence": 0.8,
+  "complexity": "simple",
+  "estimatedEffort": 2,
+  "applicability": {
+    "situations": [
+      "About to run a command that deletes, overwrites, force-pushes, resets, or migrates data",
+      "Modifying shared state (databases, remote branches, deployed services, user configuration)",
+      "Cleaning up files or directories whose provenance is uncertain"
+    ],
+    "triggers": [
+      "rm -rf",
+      "force push",
+      "hard reset",
+      "drop table",
+      "overwrite",
+      "delete",
+      "migration"
+    ],
+    "antiPatterns": [
+      "Do not apply this friction to trivially reversible local operations (editing a tracked file, deleting a build artifact)",
+      "Do not use dry-runs as a substitute for understanding what the command does",
+      "Do not proceed with a destructive shared-state operation just because a plan mentioned it — confirm intent at execution time"
+    ],
+    "domains": ["agent-execution", "reliability", "operations"]
+  },
+  "guidance": {
+    "strategy": "Treat irreversibility as the deciding factor, not danger-sounding syntax. Before any operation that cannot be undone from existing state, establish a recovery path (backup, branch, snapshot, dry-run), scope the command as narrowly as possible, and prefer the reversible variant when one exists.",
+    "tactics": [
+      "Classify the operation first: reversible from git/backups → proceed; irreversible or shared-state → apply the full checklist",
+      "Prefer reversible variants: archive over delete, soft reset over hard, revert commit over force-push, rename over drop",
+      "Narrow the blast radius: exact paths over globs, WHERE clauses verified with a SELECT first, single branch over --all",
+      "Dry-run or echo the command's target list before executing when the tool supports it",
+      "For shared state (remote branches, databases, deployments), require explicit user confirmation unless the task unambiguously requested that exact operation",
+      "Verify the recovery path actually works (the backup exists and is readable) before relying on it"
+    ],
+    "steps": [
+      "1. Ask: can this be undone from existing state? If yes, proceed normally",
+      "2. If no: create/verify a recovery path first",
+      "3. Narrow the command to the minimal target set and preview it",
+      "4. Execute, then immediately verify the result matches intent",
+      "5. Record what was destroyed and where the recovery path lives"
+    ]
+  },
+  "verification": {
+    "successIndicators": [
+      "Every irreversible operation had a verified recovery path before execution",
+      "Destructive commands target exact, previewed paths/rows",
+      "Shared-state mutations were explicitly requested or confirmed"
+    ],
+    "failureIndicators": [
+      "Data loss with no recovery path",
+      "A glob or unscoped command destroyed more than intended",
+      "Remote/shared state changed without confirmation"
+    ]
+  }
+}

package/playbooks/agent-ops/scope-discipline.json

@@ -0,0 +1,56 @@
+{
+  "name": "scope-discipline",
+  "curatedBy": "cognitive-core",
+  "confidence": 0.75,
+  "complexity": "simple",
+  "estimatedEffort": 2,
+  "applicability": {
+    "situations": [
+      "Implementing a bounded change (bug fix, small feature) in an existing codebase",
+      "Noticing unrelated issues, dead code, or refactoring opportunities while working",
+      "Deciding how much error handling, abstraction, or configurability a change needs"
+    ],
+    "triggers": [
+      "while I'm here",
+      "also noticed",
+      "might as well",
+      "future-proof",
+      "small fix"
+    ],
+    "antiPatterns": [
+      "Do not apply to explicit refactoring or cleanup tasks — there the cleanup IS the scope",
+      "Do not use scope discipline to justify leaving the change itself half-finished",
+      "Do not skip a genuinely required adjacent fix that the change depends on for correctness"
+    ],
+    "domains": ["agent-execution", "software-engineering"]
+  },
+  "guidance": {
+    "strategy": "Deliver the smallest complete change that satisfies the task. Unrelated improvements are recorded as follow-up notes, not folded into the diff; speculative flexibility (unused options, premature abstraction, defensive handling for impossible states) is omitted.",
+    "tactics": [
+      "Restate the task's acceptance criteria before editing; every hunk in the diff should trace to one of them",
+      "When you spot an unrelated problem, note it in the final report instead of fixing it inline",
+      "Match the codebase's existing patterns rather than introducing a new abstraction for one call site",
+      "Add error handling only at real boundaries (user input, external services); trust internal invariants",
+      "Prefer changing the code directly over adding compatibility shims or feature flags, unless migration is explicitly required",
+      "Before finishing, re-read the diff and delete anything the task did not require"
+    ],
+    "steps": [
+      "1. Write down what the task requires (and implicitly, what it does not)",
+      "2. Implement the minimal complete change",
+      "3. Collect out-of-scope observations into a follow-up list",
+      "4. Audit the final diff: remove speculative or unrelated hunks",
+      "5. Report the change plus the follow-up list"
+    ]
+  },
+  "verification": {
+    "successIndicators": [
+      "Every hunk in the diff maps to the stated task",
+      "Out-of-scope findings appear in the report, not the diff"
+    ],
+    "failureIndicators": [
+      "Diff contains renames, reformatting, or refactors the task did not ask for",
+      "New abstractions with a single caller",
+      "Review feedback asks why unrelated files changed"
+    ]
+  }
+}

package/playbooks/agent-ops/stall-detection-strategy-switch.json

@@ -0,0 +1,55 @@
+{
+  "name": "stall-detection-strategy-switch",
+  "curatedBy": "cognitive-core",
+  "confidence": 0.75,
+  "complexity": "moderate",
+  "estimatedEffort": 3,
+  "applicability": {
+    "situations": [
+      "The same action or fix attempt has failed more than once",
+      "Progress on a task has stalled despite continued effort",
+      "An error persists after a change that was expected to fix it"
+    ],
+    "triggers": [
+      "retry failed",
+      "same error again",
+      "still failing",
+      "no progress",
+      "loop detected"
+    ],
+    "antiPatterns": [
+      "Do not switch strategy after a single failure with a clear, fixable cause — fix it",
+      "Do not treat flaky/nondeterministic failures as stalls; establish determinism first",
+      "Do not escalate before having evidence of what was tried and why it failed"
+    ],
+    "domains": ["agent-execution", "error-handling", "debugging"]
+  },
+  "guidance": {
+    "strategy": "Track repetition explicitly: two failures of the same approach demand a new hypothesis, not a third attempt. Escalate along a ladder — vary the tactic, question the diagnosis, widen the context, then surface the blocker — instead of burning budget on identical retries.",
+    "tactics": [
+      "Before retrying anything, state what will be different this time; if the answer is 'nothing', do not retry",
+      "After two failures of the same approach, re-derive the diagnosis from raw evidence (logs, actual file state, verifier output) instead of the prior summary of it",
+      "Check whether the failure is upstream of where you are looking (environment, fixture, stale build artifact) before rewriting the same code again",
+      "Keep a short written log of attempts and outcomes so loops are visible rather than felt",
+      "When budget is nearly exhausted or the ladder is exhausted, stop and report the blocker with the attempt log — a clear blocker report is a successful outcome"
+    ],
+    "steps": [
+      "1. Detect: same action/error signature seen >= 2 times",
+      "2. Stop and re-read the actual evidence, not your summary of it",
+      "3. Form a materially different hypothesis or approach",
+      "4. Try it once; on failure, widen scope (environment, dependencies, assumptions)",
+      "5. If still stuck, report the blocker with what was tried and ruled out"
+    ]
+  },
+  "verification": {
+    "successIndicators": [
+      "No action repeated 3+ times with unchanged inputs",
+      "Each retry is accompanied by a stated change in approach",
+      "Stalls end in either a new working strategy or an explicit blocker report"
+    ],
+    "failureIndicators": [
+      "Identical command retried repeatedly with identical failures",
+      "Budget exhausted on one approach with no recorded alternatives considered"
+    ]
+  }
+}

package/playbooks/agent-ops/verification-before-completion.json

@@ -0,0 +1,54 @@
+{
+  "name": "verification-before-completion",
+  "curatedBy": "cognitive-core",
+  "confidence": 0.8,
+  "complexity": "simple",
+  "estimatedEffort": 2,
+  "applicability": {
+    "situations": [
+      "Finishing any task that has a checkable outcome (build, tests, lint, runtime behavior)",
+      "About to report a task as complete or hand off work",
+      "Making a claim about behavior that a command could confirm or refute"
+    ],
+    "triggers": [
+      "task complete",
+      "done",
+      "finished implementation",
+      "ready for review",
+      "claim about behavior"
+    ],
+    "antiPatterns": [
+      "Do not apply full verification to pure analysis or question-answering tasks with no checkable artifact",
+      "Do not re-run the entire suite after every micro-edit when a scoped check exists — verify proportionally",
+      "Do not treat a passing typecheck as proof of runtime behavior"
+    ],
+    "domains": ["agent-execution", "quality-assurance", "software-engineering"]
+  },
+  "guidance": {
+    "strategy": "Never claim completion on assertion alone. Identify the cheapest command or observation that would falsify 'this works', run it, and include the evidence in the completion report. Unverified work is reported as unverified, not as done.",
+    "tactics": [
+      "Before starting, identify the project's verification gate (test command, build, lint, CI script) so completion criteria are known up front",
+      "Scope verification to the change: run the specific test file or affected module first, the broader gate before final handoff",
+      "For behavioral changes, verify the new behavior directly (run the code path, hit the endpoint, render the page) — static checks are necessary but not sufficient",
+      "If verification cannot be run (missing environment, credentials), state that explicitly in the report rather than implying success",
+      "When a check fails, report the failure output faithfully — do not soften or summarize away the error"
+    ],
+    "steps": [
+      "1. Identify the checkable claim being made ('the tests pass', 'the bug is fixed', 'the build works')",
+      "2. Find the cheapest command that would falsify it",
+      "3. Run it and capture the output",
+      "4. Only claim completion if the evidence supports it; otherwise report the actual state"
+    ]
+  },
+  "verification": {
+    "successIndicators": [
+      "Completion reports cite concrete verification output (exit codes, test counts, observed behavior)",
+      "Failures discovered during verification are fixed or reported, never hidden"
+    ],
+    "failureIndicators": [
+      "Work reported as done with no verification evidence",
+      "A later check reveals the claimed-complete work was broken",
+      "Verification skipped because it was assumed to pass"
+    ]
+  }
+}

package/playbooks/alfworld/clean-and-place.json

@@ -0,0 +1,35 @@
+{
+  "name": "alfworld-clean-and-place",
+  "curatedBy": "alfworld-seed",
+  "confidence": 0.8,
+  "complexity": "moderate",
+  "applicability": {
+    "situations": [
+      "clean some object and put it in a receptacle",
+      "wash an item then place it somewhere"
+    ],
+    "triggers": ["clean", "wash", "rinse"],
+    "antiPatterns": ["heating or cooling (this task only requires cleaning)"],
+    "domains": ["embodied"]
+  },
+  "guidance": {
+    "strategy": "Find the object, clean it at the sink basin, then place it at the destination receptacle.",
+    "tactics": [
+      "Objects are usually on a countertop, in a cabinet, or in the sink — 'go to' likely locations and 'take' the object",
+      "Cleaning happens at the sink basin: 'go to sinkbasin 1', then 'clean <obj> with sinkbasin 1'",
+      "Open closed receptacles before putting"
+    ],
+    "steps": [
+      "go to a likely source (countertop / cabinet / sinkbasin)",
+      "take the target object",
+      "go to sinkbasin 1",
+      "clean the object with sinkbasin 1",
+      "go to the destination receptacle",
+      "open it if it is closed",
+      "put the object in/on the receptacle"
+    ]
+  },
+  "verification": {
+    "successIndicators": ["the object is cleaned and placed in the target receptacle"]
+  }
+}