akm-cli 0.7.4 → 0.8.0-rc.3

package/dist/workflows/runs.js

@@ -12,55 +12,64 @@ import { resolveAssetPath } from "../sources/resolve";
 import { formatWorkflowErrors } from "./authoring";
 import { closeWorkflowDatabase, openWorkflowDatabase } from "./db";
 import { parseWorkflow } from "./parser";
+import { getCurrentWorkflowScopeKey } from "./scope-key";
+async function withWorkflowDb(fn) {
+    const db = openWorkflowDatabase();
+    try {
+        return await Promise.resolve(fn(db));
+    }
+    finally {
+        closeWorkflowDatabase(db);
+    }
+}
 export async function startWorkflowRun(ref, params = {}) {
     const asset = await loadWorkflowAsset(ref);
-    const workflowDb = openWorkflowDatabase();
-    try {
+    return withWorkflowDb(async (db) => {
         const now = new Date().toISOString();
         const runId = randomUUID();
+        const scopeKey = getCurrentWorkflowScopeKey();
         const currentStepId = asset.steps[0]?.id ?? null;
         const workflowEntryId = resolveWorkflowEntryId(asset.sourcePath, asset.ref);
-        workflowDb.transaction(() => {
-            workflowDb
-                .prepare(`INSERT INTO workflow_runs (
-          id, workflow_ref, workflow_entry_id, workflow_title, status, params_json, current_step_id, created_at, updated_at
-        ) VALUES (?, ?, ?, ?, 'active', ?, ?, ?, ?)`)
-                .run(runId, asset.ref, workflowEntryId, asset.title, JSON.stringify(params), currentStepId, now, now);
-            const insertStep = workflowDb.prepare(`INSERT INTO workflow_run_steps (
+        db.transaction(() => {
+            db.prepare(`INSERT INTO workflow_runs (
+          id, workflow_ref, scope_key, workflow_entry_id, workflow_title, status, params_json, current_step_id, created_at, updated_at
+        ) VALUES (?, ?, ?, ?, ?, 'active', ?, ?, ?, ?)`).run(runId, asset.ref, scopeKey, workflowEntryId, asset.title, JSON.stringify(params), currentStepId, now, now);
+            const insertStep = db.prepare(`INSERT INTO workflow_run_steps (
           run_id, step_id, step_title, instructions, completion_json, sequence_index, status
         ) VALUES (?, ?, ?, ?, ?, ?, 'pending')`);
             for (const step of asset.steps) {
                 insertStep.run(runId, step.id, step.title, step.instructions, step.completionCriteria ? JSON.stringify(step.completionCriteria) : null, step.sequenceIndex ?? 0);
             }
         })();
-        const result = getWorkflowStatus(runId);
+        const result = await getWorkflowStatus(runId);
         appendEvent({
             eventType: "workflow_started",
             ref: ref,
             metadata: { runId: result.run.id, title: result.run.workflowTitle },
         });
         return result;
-    }
-    finally {
-        closeWorkflowDatabase(workflowDb);
-    }
+    });
 }
-export function getWorkflowStatus(runId) {
-    const workflowDb = openWorkflowDatabase();
-    try {
-        const run = readWorkflowRun(workflowDb, runId);
-        const steps = readWorkflowRunSteps(workflowDb, run.id);
+export async function getWorkflowStatus(runId) {
+    return withWorkflowDb((db) => {
+        const run = readWorkflowRun(db, runId);
+        const steps = readWorkflowRunSteps(db, run.id);
         return buildWorkflowRunDetail(run, steps);
-    }
-    finally {
-        closeWorkflowDatabase(workflowDb);
-    }
+    });
 }
-export function listWorkflowRuns(input) {
-    const workflowDb = openWorkflowDatabase();
-    try {
+export async function hasWorkflowRun(runId) {
+    return withWorkflowDb((db) => {
+        const row = db.prepare("SELECT 1 FROM workflow_runs WHERE id = ? LIMIT 1").get(runId);
+        return !!row;
+    });
+}
+export async function listWorkflowRuns(input) {
+    return withWorkflowDb((db) => {
         const filters = [];
         const params = [];
+        const scopeKey = getCurrentWorkflowScopeKey();
+        filters.push("scope_key = ?");
+        params.push(scopeKey);
         if (input?.workflowRef) {
             const parsed = parseAssetRef(input.workflowRef);
             if (parsed.type !== "workflow") {
@@ -73,20 +82,16 @@ export function listWorkflowRuns(input) {
             filters.push("status IN ('active', 'blocked')");
         }
         const where = filters.length > 0 ? `WHERE ${filters.join(" AND ")}` : "";
-        const rows = workflowDb
+        const rows = db
             .prepare(`SELECT * FROM workflow_runs ${where} ORDER BY updated_at DESC, created_at DESC`)
             .all(...params);
         return { runs: rows.map(toWorkflowRunSummary) };
-    }
-    finally {
-        closeWorkflowDatabase(workflowDb);
-    }
+    });
 }
 export async function getNextWorkflowStep(specifier, params) {
-    const workflowDb = openWorkflowDatabase();
-    try {
-        const { run, autoStarted } = await resolveRunSpecifier(workflowDb, specifier, params);
-        const steps = readWorkflowRunSteps(workflowDb, run.id);
+    return withWorkflowDb(async (db) => {
+        const { run, autoStarted } = await resolveRunSpecifier(db, specifier, params);
+        const steps = readWorkflowRunSteps(db, run.id);
         const currentStep = resolveCurrentStep(run, steps);
         const done = run.status === "completed" ? true : undefined;
         return {
@@ -100,54 +105,44 @@ export async function getNextWorkflowStep(specifier, params) {
             ...(done ? { done } : {}),
             ...(autoStarted ? { autoStarted } : {}),
         };
-    }
-    finally {
-        closeWorkflowDatabase(workflowDb);
-    }
+    });
 }
-export function resumeWorkflowRun(runId) {
-    const workflowDb = openWorkflowDatabase();
-    try {
-        const run = readWorkflowRun(workflowDb, runId);
+export async function resumeWorkflowRun(runId) {
+    return withWorkflowDb((db) => {
+        const run = readWorkflowRun(db, runId);
         if (run.status === "completed") {
             throw new UsageError(`Workflow run ${run.id} is already completed and cannot be resumed.`);
         }
         if (run.status === "active") {
-            const steps = readWorkflowRunSteps(workflowDb, run.id);
+            const steps = readWorkflowRunSteps(db, run.id);
             return buildWorkflowRunDetail(run, steps);
         }
         // blocked or failed → flip back to active and re-open the current step so
         // it can be reclassified (completed, failed, skipped) after resuming.
         const now = new Date().toISOString();
-        workflowDb.transaction(() => {
+        db.transaction(() => {
             if (run.current_step_id) {
-                workflowDb
-                    .prepare(`UPDATE workflow_run_steps
+                db.prepare(`UPDATE workflow_run_steps
              SET status = 'pending', notes = NULL, evidence_json = NULL, completed_at = NULL
-             WHERE run_id = ? AND step_id = ? AND status IN ('blocked', 'failed')`)
-                    .run(run.id, run.current_step_id);
+             WHERE run_id = ? AND step_id = ? AND status IN ('blocked', 'failed')`).run(run.id, run.current_step_id);
             }
-            workflowDb.prepare("UPDATE workflow_runs SET status = 'active', updated_at = ? WHERE id = ?").run(now, run.id);
+            db.prepare("UPDATE workflow_runs SET status = 'active', updated_at = ? WHERE id = ?").run(now, run.id);
         })();
         const updated = { ...run, status: "active", updated_at: now };
-        const steps = readWorkflowRunSteps(workflowDb, run.id);
+        const steps = readWorkflowRunSteps(db, run.id);
         return buildWorkflowRunDetail(updated, steps);
-    }
-    finally {
-        closeWorkflowDatabase(workflowDb);
-    }
+    });
 }
-export function completeWorkflowStep(input) {
-    const workflowDb = openWorkflowDatabase();
-    try {
+export async function completeWorkflowStep(input) {
+    return withWorkflowDb((db) => {
         let updatedRun;
         let refreshedSteps = [];
-        workflowDb.transaction(() => {
-            const run = readWorkflowRun(workflowDb, input.runId);
+        db.transaction(() => {
+            const run = readWorkflowRun(db, input.runId);
             if (run.status !== "active") {
                 throw new UsageError(`Workflow run ${run.id} is ${run.status} and cannot be updated.`);
             }
-            const existing = workflowDb
+            const existing = db
                 .prepare("SELECT * FROM workflow_run_steps WHERE run_id = ? AND step_id = ?")
                 .get(run.id, input.stepId);
             if (!existing) {
@@ -160,18 +155,14 @@ export function completeWorkflowStep(input) {
                 throw new UsageError(`Step "${input.stepId}" is not the current step for workflow run ${run.id}. Complete "${run.current_step_id}" first.`);
             }
             const completedAt = new Date().toISOString();
-            workflowDb
-                .prepare(`UPDATE workflow_run_steps
+            db.prepare(`UPDATE workflow_run_steps
            SET status = ?, notes = ?, evidence_json = ?, completed_at = ?
-           WHERE run_id = ? AND step_id = ?`)
-                .run(input.status, input.notes?.trim() || null, input.evidence ? JSON.stringify(input.evidence) : null, completedAt, run.id, input.stepId);
-            refreshedSteps = readWorkflowRunSteps(workflowDb, run.id);
+           WHERE run_id = ? AND step_id = ?`).run(input.status, input.notes?.trim() || null, input.evidence ? JSON.stringify(input.evidence) : null, completedAt, run.id, input.stepId);
+            refreshedSteps = readWorkflowRunSteps(db, run.id);
             const state = deriveRunState(refreshedSteps);
-            workflowDb
-                .prepare(`UPDATE workflow_runs
+            db.prepare(`UPDATE workflow_runs
            SET status = ?, current_step_id = ?, updated_at = ?, completed_at = ?
-           WHERE id = ?`)
-                .run(state.status, state.currentStepId, completedAt, state.completedAt, run.id);
+           WHERE id = ?`).run(state.status, state.currentStepId, completedAt, state.completedAt, run.id);
             updatedRun = {
                 ...run,
                 status: state.status,
@@ -190,10 +181,7 @@ export function completeWorkflowStep(input) {
             appendEvent({ eventType: "workflow_finished", ref: detail.run.workflowRef, metadata: { runId: input.runId } });
         }
         return detail;
-    }
-    finally {
-        closeWorkflowDatabase(workflowDb);
-    }
+    });
 }
 async function resolveRunSpecifier(db, specifier, params) {
     const explicitRun = db.prepare("SELECT * FROM workflow_runs WHERE id = ?").get(specifier);
@@ -211,9 +199,10 @@ async function resolveRunSpecifier(db, specifier, params) {
         throw new UsageError(`Expected a workflow ref or workflow run id, got "${specifier}".`);
     }
     const ref = `${parsed.origin ? `${parsed.origin}//` : ""}workflow:${parsed.name}`;
+    const scopeKey = getCurrentWorkflowScopeKey();
     const active = db
-        .prepare("SELECT * FROM workflow_runs WHERE workflow_ref = ? AND status = 'active' ORDER BY updated_at DESC LIMIT 1")
-        .get(ref);
+        .prepare("SELECT * FROM workflow_runs WHERE workflow_ref = ? AND scope_key = ? AND status = 'active' ORDER BY updated_at DESC LIMIT 1")
+        .get(ref, scopeKey);
     if (active) {
         if (params && Object.keys(params).length > 0) {
             throw new UsageError(`--params can only be set on a new run; ${ref} already has an active run`);
@@ -246,7 +235,7 @@ async function loadWorkflowAsset(ref) {
     if (!assetPath) {
         throw new NotFoundError(`Workflow not found for ref: workflow:${parsed.name}`);
     }
-    const resolvedSourcePath = sourcePath ?? loadConfig().stashDir ?? assetPath;
+    const resolvedSourcePath = sourcePath ?? config.stashDir ?? assetPath;
     const fullRef = `${parsed.origin ? `${parsed.origin}//` : ""}workflow:${parsed.name}`;
     const cached = readWorkflowDocumentFromIndex(resolvedSourcePath, fullRef);
     const document = cached ?? loadWorkflowDocumentFromDisk(assetPath);
@@ -358,6 +347,7 @@ function toWorkflowRunSummary(run) {
     return {
         id: run.id,
         workflowRef: run.workflow_ref,
+        scopeKey: run.scope_key,
         workflowEntryId: run.workflow_entry_id,
         workflowTitle: run.workflow_title,
         status: run.status,
@@ -435,18 +425,13 @@ function parseJsonArray(value) {
     }
     return undefined;
 }
-export function getActiveWorkflowRun() {
-    try {
-        const workflowDb = openWorkflowDatabase();
-        const row = workflowDb
-            .query("SELECT id, current_step_id, workflow_ref FROM workflow_runs WHERE status IN ('active', 'blocked') ORDER BY updated_at DESC LIMIT 1")
-            .get();
-        closeWorkflowDatabase(workflowDb);
+export async function getActiveWorkflowRun(scopeKey = getCurrentWorkflowScopeKey()) {
+    return withWorkflowDb((db) => {
+        const row = db
+            .query("SELECT id, current_step_id, workflow_ref FROM workflow_runs WHERE scope_key = ? AND status IN ('active', 'blocked') ORDER BY updated_at DESC LIMIT 1")
+            .get(scopeKey);
         if (!row)
             return null;
         return { runId: row.id, stepId: row.current_step_id, workflowRef: row.workflow_ref };
-    }
-    catch {
-        return null; // fail-open: never crash show output due to DB error
-    }
+    }).catch(() => null); // fail-open: never crash show output due to DB error
 }

package/dist/workflows/scope-key.js

@@ -0,0 +1,76 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { isWithin, resolveStashDir, safeRealpath, toPosix } from "../core/common";
+const PROJECT_CONFIG_RELATIVE_PATH = path.join(".akm", "config.json");
+export function getCurrentWorkflowScopeKey() {
+    const anchor = resolveWorkflowScopeAnchor(process.cwd());
+    const normalized = normalizeScopePath(anchor);
+    const digest = createHash("sha256").update(normalized).digest("hex");
+    return `dir:v1:${digest}`;
+}
+export function resolveWorkflowScopeAnchor(startDir) {
+    const cwd = safeRealpath(startDir);
+    const projectRoot = findNearestProjectConfigRoot(cwd);
+    if (projectRoot)
+        return projectRoot;
+    const gitRoot = findNearestGitRoot(cwd);
+    if (gitRoot)
+        return gitRoot;
+    try {
+        const stashDir = safeRealpath(resolveStashDir({ readOnly: true }));
+        if (isWithin(cwd, stashDir))
+            return stashDir;
+    }
+    catch {
+        // Ignore stash resolution failures and fall back to cwd.
+    }
+    return cwd;
+}
+function findNearestProjectConfigRoot(startDir) {
+    let currentDir = startDir;
+    while (true) {
+        const configPath = path.join(currentDir, PROJECT_CONFIG_RELATIVE_PATH);
+        if (isFile(configPath)) {
+            return safeRealpath(currentDir);
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            return null;
+        currentDir = parentDir;
+    }
+}
+function findNearestGitRoot(startDir) {
+    let currentDir = startDir;
+    while (true) {
+        const gitPath = path.join(currentDir, ".git");
+        if (exists(gitPath)) {
+            return safeRealpath(currentDir);
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            return null;
+        currentDir = parentDir;
+    }
+}
+function exists(candidate) {
+    try {
+        fs.accessSync(candidate, fs.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isFile(candidate) {
+    try {
+        return fs.statSync(candidate).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeScopePath(value) {
+    const posix = toPosix(value);
+    return process.platform === "win32" ? posix.toLowerCase() : posix;
+}

package/dist/workflows/validator.js

@@ -6,7 +6,7 @@
  * step-id format, and the frontmatter key whitelist.
  */
 const STEP_ID_REGEX = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
-const ALLOWED_FRONTMATTER_KEYS = new Set(["description", "tags", "params"]);
+const ALLOWED_FRONTMATTER_KEYS = new Set(["description", "tags", "params", "name", "updated"]);
 export function runSemanticChecks(draft, frontmatterData, frontmatterEndLine, errors) {
     checkFrontmatterKeys(frontmatterData, frontmatterEndLine, errors);
     checkStepIdFormat(draft, errors);

package/dist/workflows/workflow-template.md

@@ -0,0 +1,24 @@
+---
+description: Describe what this workflow accomplishes
+tags:
+  - example
+params:
+  example_param: Explain this parameter
+---
+
+# Workflow: {{TITLE}}
+
+## Step: {{FIRST_STEP_TITLE}}
+Step ID: {{FIRST_STEP_ID}}
+
+### Instructions
+Describe what to do in this step.
+
+### Completion Criteria
+- Confirm the first step is complete
+
+## Step: Second Step
+Step ID: second-step
+
+### Instructions
+Describe what happens next.

package/docs/README.md

@@ -11,7 +11,7 @@
 ## Upgrading
 
 - [v1 migration guide](migration/v1.md) -- The path from 0.x to v1.0, including the `.stash.json` removal scheduled for v0.8.0
-- [Release notes (latest: 0.7.0)](migration/release-notes/0.7.0.md) -- Per-release notes drop into `migration/release-notes/`, including current pre-release removals
+- [Release notes (latest: 0.8.0)](migration/release-notes/0.8.0.md) -- Per-release notes drop into `migration/release-notes/`, including current pre-release removals
 - [v0.5 → v0.6 migration guide](migration/v0.5-to-v0.6.md) -- Every breaking change with before/after code, publisher checklist, and troubleshooting
 
 ## Reference
@@ -33,12 +33,15 @@
 - [Search](technical/search.md) -- Hybrid search architecture and scoring
 - [Indexing](technical/indexing.md) -- How the search index is built
 - [Classification](technical/classification.md) -- Matcher and renderer behavior
+- [Functional Contract Patterns](technical/functional-contract-patterns.md) -- Quick reference for contributor pipelines and small process contracts
+- [Implementation Plan: Functional Contract Refactor](technical/implementation-plan-functional-contract-refactor.md) -- Phased plan to move behavior from type-centric switchboards to process-local contributors
+- [Architecture Cleanup Checklist](technical/architecture-cleanup-checklist.md) -- Living checklist for executing the cleanup plan with parity gates, reviews, and git hygiene
 - [Show Response](technical/show-response.md) -- `akm show` output fields by asset type
 - [Testing Workflow](technical/testing-workflow.md) -- End-to-end, Docker, deployment, and upgrade validation
 - [Ref Format](technical/ref.md) -- Wire format for asset references
 - [Test Coverage Guide](technical/test-coverage-guide.md) -- High-value testing areas
 - [Core Principles](technical/akm-core-principles.md) -- Design principles and constraints
-- [akm-bench](technical/benchmark.md) -- Search-quality benchmark suite
+- `technical/benchmark.md` (planned) -- Search-quality benchmark suite
 
 ## Posts
 

package/docs/migration/release-notes/0.7.0.md

@@ -90,7 +90,7 @@ until the user opts in. Seven keys ship in 0.7.0:
 | `feedback_distillation` | `akm distill <ref>` |
 | `embedding_fallback_score` | scorer fallback when embeddings unavailable |
 | `memory_inference` | indexer split of pending memories into atomic facts |
-| `graph_extraction` | indexer entity/relation extraction → `graph.json` |
+| `graph_extraction` | indexer entity/relation extraction → SQLite graph tables |
 
 Every gated call site uses `tryLlmFeature(feature, config, fn, fallback)`
 from `src/llm/feature-gate.ts`. The wrapper guarantees:

package/docs/migration/release-notes/0.7.4.md

@@ -14,4 +14,4 @@ This is a patch release that fixes the publish process. No functional changes fr
 - **`.stash.json` no longer drives incremental stale detection** — editing `.stash.json` alone no longer forces directories to rescan during incremental indexing.
 - **One-shot URL ingest for `akm import` and `akm wiki stash`** — both commands now accept a single HTTP/HTTPS URL in addition to file paths and stdin. `akm import <url>` fetches the exact page, converts it to markdown, and writes it into `knowledge/` using a URL-path-derived default name. `akm wiki stash <wiki> <url>` fetches the exact page, converts it to markdown, and writes it into `wikis/<wiki>/raw/`. Neither command registers a persistent website source or crawls linked pages.
 
-For stash authors on the 0.7.x pre-release line: `.stash.json` remains supported for compatibility in this release, but it is deprecated and will be removed in v0.8.0. That timeline is intentional: during this aggressive pre-release phase-out window, compatibility shims do not stay around until 1.0 unless they still earn their cost. Prefer frontmatter for markdown assets and structured code comments for scripts, and migrate any remaining `.stash.json` metadata before taking the 0.8 upgrade.
+For stash authors on the 0.7.x pre-release line: `.stash.json` remains supported for compatibility in this release, but it is deprecated and will be removed in v0.8.0. That timeline is intentional: during this aggressive pre-release phase-out window, compatibility shims do not stay around until 1.0 unless they still earn their cost. Prefer frontmatter for markdown assets and structured code comments for scripts, and migrate any remaining `.stash.json` metadata before taking the 0.8 upgrade.

package/docs/migration/release-notes/0.7.5.md

@@ -0,0 +1,20 @@
+Migration notes for akm v0.7.5
+
+0.7.5 is a patch release that rolls up all changes shipped on `main` after v0.7.4.
+
+- **Workflow runs are now workspace-scoped** — ref-based workflow commands (`workflow next`, `workflow status`, `workflow list`) now resolve runs within the current project/worktree/directory instead of sharing one global active-run pool across every repo and local sandbox. This fixes cross-repo blocking and leakage for workflow refs such as `workflow:github-issues-parallel-implementer`. Direct run-id commands still target the exact run.
+- **Workflow help/docs now explain scope semantics** — CLI help, operator docs, and workflow-facing hints now describe the current-scope behavior so teams know that ref-based run resolution is local to the current workspace.
+- **`show` now prefers fresh index state** — stale index reads auto-refresh instead of silently falling back to a raw filesystem path, reducing search/show drift.
+- **External agent + LLM parsing is more defensive** — reflect/propose and related local-model JSON parsing paths are hardened against malformed or partial output.
+- **Reflect temp-file handling is safer** — draft files for reflection flows now live in OS temp space instead of the stash.
+- **Memory inference respects token budgets** — long inputs are now trimmed to the configured LLM budget.
+- **Vault and save follow-ups landed** — vault path/run flows and named git stash selection in `akm save` received targeted fixes and regression coverage.
+- **Release/migration packaging is tighter** — published static files, changelog resolution, and rerunnable release automation received follow-up fixes.
+
+No manual migration is required for most users, but note these operator-facing details:
+
+1. If you were relying on ref-based workflow runs being globally shared across repos or directories, that behavior is gone. Use direct run IDs when you intentionally need to resume a specific run created elsewhere.
+2. Existing older workflow runs created before the new workspace scope key was introduced are still accessible by direct run ID, but ref-based commands now prefer runs created in the current scope.
+3. `akm help migrate latest` now resolves to 0.7.5 and uses the published `.github/CHANGELOG.md` path.
+
+Full changelog: https://github.com/itlackey/akm/blob/main/.github/CHANGELOG.md

package/docs/migration/release-notes/0.8.0.md

@@ -0,0 +1,43 @@
+Migration notes for akm v0.8.0
+
+This release combines the 0.8.0 CLI/storage break with the final improve-owned
+maintenance migration work that landed before release validation closed.
+
+Key operator-facing changes:
+
+- `akm index --enrich` and `akm index --re-enrich` are removed.
+- Plain `akm index` now owns metadata enhancement only.
+- Memory inference and graph extraction now run from `akm improve` after
+  consolidation, not from `akm index`.
+- Manual QA and sandbox guidance now require isolating `AKM_DATA_DIR` in
+  addition to `HOME`, XDG dirs, and `AKM_STASH_DIR`.
+- `akm health` is available for post-upgrade runtime checks against `state.db`,
+  task-history integrity, agent availability, and recent improve telemetry.
+
+Primary public command family for 0.8.0:
+
+- `akm improve [<type>|<ref>]`
+- `akm propose <type> <name> (--task "..." | --file <path>)`
+- `akm proposals`
+- `akm show proposal <id>`
+- `akm diff proposal <id>`
+- `akm accept <id>`
+- `akm reject <id> --reason "..."`
+
+Proposal-queue and improvement workflows are consolidated around this family.
+Update scripts, prompts, docs, and agent instructions before upgrading.
+
+Behavior changes worth noting:
+
+- `akm search` with no query now fails with `MISSING_REQUIRED_ARGUMENT`.
+- `akm remember --enrich` is fail-soft: if no LLM is configured, the memory is
+  still written.
+- `akm wiki stash <wiki> <url>` once again fetches and stores URL snapshots in
+  `wikis/<name>/raw/`.
+- `akm health --since 24h` provides a fast operator check for state-db
+  round-trip health, task-log backing, and recent improve outcomes.
+
+Release validation status for the final 0.8.0 cut:
+
+- Full repo test suite passed.
+- Docker install matrix passed for both Bun and binary install paths.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.7.4",
+  "version": "0.8.0-rc.3",
   "type": "module",
   "description": "akm (Agent Kit Manager) — A package manager for AI agent skills, commands, tools, and knowledge. Works with Claude Code, OpenCode, Cursor, and any AI coding assistant.",
   "keywords": [
@@ -34,7 +34,7 @@
   "files": [
     "dist",
     "README.md",
-    "CHANGELOG.md",
+    ".github/CHANGELOG.md",
     "LICENSE",
     "docs/migration/release-notes"
   ],
@@ -42,7 +42,7 @@
     "akm": "dist/cli.js"
   },
   "scripts": {
-    "build": "rm -rf dist && bun run tsc --project ./tsconfig.build.json",
+    "build": "rm -rf dist && bun run tsc --project ./tsconfig.build.json && bun scripts/copy-assets.ts",
     "check": "bun run lint && bunx tsc --noEmit && bun test ./tests",
     "check:changed": "bun test tests/output-baseline.test.ts tests/e2e.test.ts tests/stash-search.test.ts && bun run lint && bunx tsc --noEmit",
     "test": "bun test ./tests",
@@ -74,6 +74,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.3.0",
+    "@opencode-ai/sdk": "1.2.20",
     "citty": "^0.2.2",
     "dotenv": "^17.4.2",
     "yaml": "^2.8.4"

package/dist/templates/wiki-templates.js

@@ -1,100 +0,0 @@
-/**
- * Scaffolded content for a fresh `wikis/<name>/` directory.
- *
- * Inlined as TypeScript constants so they ship with the published bundle
- * (the build step is `tsc` — non-TS files are not copied to dist).
- *
- * The scaffold is deliberately minimal: akm does not prescribe conventions
- * beyond the three-layer layout. `schema.md` is the per-wiki rulebook the
- * agent reads first; authors customise it freely.
- */
-export function buildSchemaMd(wikiName) {
-    return `---
-description: Rules that govern this wiki. Read before ingesting, searching, or editing pages.
-wikiRole: schema
----
-
-# ${wikiName} wiki schema
-
-This wiki follows the three-layer pattern:
-
-- \`raw/\` — immutable ingested sources (never edit)
-- \`<page>.md\` and \`<topic>/<page>.md\` — agent-authored pages
-- \`schema.md\` (this file), \`index.md\`, \`log.md\` — wiki-level metadata
-
-## Page frontmatter
-
-Every page should carry frontmatter so akm can index and link it:
-
-\`\`\`yaml
----
-description: one-sentence summary used in search and lint
-pageKind: entity | concept | question | note | <your-custom-kind>
-xrefs:
-  - wiki:${wikiName}/other-page
-sources:
-  - raw/<slug>.md
----
-\`\`\`
-
-\`pageKind\` accepts any non-empty string. Add new categories freely; they
-will surface in \`index.md\` as new sections after the next \`akm index\` run.
-
-## Three operations
-
-### Ingest
-
-1. Copy the new source into \`raw/\` with \`akm wiki stash ${wikiName} <path>\`.
-2. Find related pages: \`akm wiki search ${wikiName} "<terms>"\`.
-3. For each related page: append a section, note a contradiction, or create a
-   new page. Update xrefs on both sides.
-4. Cite the raw source in each touched page's \`sources:\` frontmatter.
-5. Append one entry to \`log.md\` describing what was assimilated.
-
-### Query
-
-1. \`akm wiki search ${wikiName} "<question>"\` — find candidate pages.
-2. \`akm show wiki:${wikiName}/<page>\` — read the top hits.
-3. Compose the answer from the wiki; cite raw sources only when the wiki
-   points at them.
-
-### Lint
-
-1. \`akm wiki lint ${wikiName}\` — deterministic structural checks.
-2. Resolve each finding: link orphans, fix broken xrefs, add descriptions,
-   cite uncited raws, refresh the index.
-
-## Hard rules
-
-- \`raw/\` is immutable. Never edit ingested sources.
-- Cross-references must point at pages that actually exist.
-- Prefer appending to an existing page over duplicating one.
-- Cite the raw source id (e.g. \`raw/2026-04-foo.md\`) when copying claims.
-`;
-}
-export function buildIndexMd(wikiName) {
-    return `---
-description: Catalog of pages in the ${wikiName} wiki. Regenerated by \`akm index\`.
-wikiRole: index
----
-
-# ${wikiName} — index
-
-_This file is regenerated on every \`akm index\` run. Manual edits are
-preserved until the next regeneration, then replaced._
-
-_(no pages yet — create one with your editor, or ingest a source with \`akm
-wiki stash ${wikiName} <path>\`.)_
-`;
-}
-export function buildLogMd(wikiName) {
-    return `---
-description: Append-only log for the ${wikiName} wiki. Newest entries at the top.
-wikiRole: log
----
-
-# ${wikiName} — log
-
-_Each entry: ISO date, operation, brief summary._
-`;
-}