akm-cli 0.9.0-rc.8 → 0.9.0

package/dist/migrate/legacy/workflow-migrations-bodies.js

@@ -1,52 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Frozen `ensureBaseSchema` baseline DDL — the `workflow_runs` /
- * `workflow_run_steps` tables as `openWorkflowDatabase` created them before
- * evaluating the migration list. Idempotent (`CREATE TABLE IF NOT EXISTS`), so
- * running it against an existing workflow.db is a no-op.
- */
-export const FROZEN_WORKFLOW_BASE_SCHEMA_DDL = "\n    CREATE TABLE IF NOT EXISTS workflow_runs (\n      id                TEXT PRIMARY KEY,\n      workflow_ref      TEXT NOT NULL,\n      workflow_entry_id INTEGER,\n      workflow_title    TEXT NOT NULL,\n      status            TEXT NOT NULL CHECK (status IN ('active', 'completed', 'blocked', 'failed')),\n      params_json       TEXT NOT NULL DEFAULT '{}',\n      current_step_id   TEXT,\n      created_at        TEXT NOT NULL,\n      updated_at        TEXT NOT NULL,\n      completed_at      TEXT\n    );\n\n    CREATE INDEX IF NOT EXISTS idx_workflow_runs_ref ON workflow_runs(workflow_ref);\n    CREATE INDEX IF NOT EXISTS idx_workflow_runs_status ON workflow_runs(status);\n\n    CREATE TABLE IF NOT EXISTS workflow_run_steps (\n      run_id          TEXT NOT NULL,\n      step_id         TEXT NOT NULL,\n      step_title      TEXT NOT NULL,\n      instructions    TEXT NOT NULL,\n      completion_json TEXT,\n      sequence_index  INTEGER NOT NULL,\n      status          TEXT NOT NULL CHECK (status IN ('pending', 'completed', 'blocked', 'failed', 'skipped')),\n      notes           TEXT,\n      evidence_json   TEXT,\n      completed_at    TEXT,\n      PRIMARY KEY (run_id, step_id),\n      FOREIGN KEY (run_id) REFERENCES workflow_runs(id) ON DELETE CASCADE\n    );\n\n    CREATE INDEX IF NOT EXISTS idx_workflow_run_steps_run_sequence\n      ON workflow_run_steps(run_id, sequence_index);\n  ";
-/**
- * Frozen `{ id, up }` snapshot of the 10 `WORKFLOW_MIGRATIONS` bodies at the akm
- * 0.9.0 pre-cutover HEAD. Order is significant — it is the exact append-only
- * migration order `runSqliteMigrations` applies against a pre-cutover
- * workflow.db.
- */
-export const FROZEN_WORKFLOW_MIGRATIONS = [
-    {
-        id: "001-add-scope-key",
-        up: "\n      ALTER TABLE workflow_runs ADD COLUMN scope_key TEXT;\n\n      CREATE INDEX IF NOT EXISTS idx_workflow_runs_scope_ref_status\n        ON workflow_runs(scope_key, workflow_ref, status);\n    ",
-    },
-    {
-        id: "002-add-agent-identity",
-        up: "\n      ALTER TABLE workflow_runs ADD COLUMN agent_harness TEXT;\n      ALTER TABLE workflow_runs ADD COLUMN agent_session_id TEXT;\n\n      CREATE INDEX IF NOT EXISTS idx_workflow_runs_agent_session\n        ON workflow_runs(agent_harness, agent_session_id);\n    ",
-    },
-    {
-        id: "003-checkin-and-step-summary",
-        up: "\n      ALTER TABLE workflow_runs ADD COLUMN checkin_armed_at TEXT;\n      ALTER TABLE workflow_run_steps ADD COLUMN summary TEXT;\n    ",
-    },
-    {
-        id: "004-workflow-run-units",
-        up: "\n      CREATE TABLE IF NOT EXISTS workflow_run_units (\n        run_id         TEXT NOT NULL,\n        unit_id        TEXT NOT NULL,\n        step_id        TEXT,\n        node_id        TEXT NOT NULL,\n        parent_unit_id TEXT,\n        phase          TEXT,\n        runner         TEXT,\n        model          TEXT,\n        status         TEXT NOT NULL CHECK (status IN ('pending', 'running', 'completed', 'failed', 'skipped')),\n        input_hash     TEXT,\n        result_json    TEXT,\n        tokens         INTEGER,\n        failure_reason TEXT,\n        worktree_path  TEXT,\n        started_at     TEXT,\n        finished_at    TEXT,\n        PRIMARY KEY (run_id, unit_id),\n        FOREIGN KEY (run_id) REFERENCES workflow_runs(id) ON DELETE CASCADE\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_workflow_run_units_run_step\n        ON workflow_run_units(run_id, step_id);\n    ",
-    },
-    { id: "005-unit-session-id", up: "\n      ALTER TABLE workflow_run_units ADD COLUMN session_id TEXT;\n    " },
-    {
-        id: "006-frozen-plan-and-lease",
-        up: "\n      ALTER TABLE workflow_runs ADD COLUMN plan_json TEXT;\n      ALTER TABLE workflow_runs ADD COLUMN plan_hash TEXT;\n      ALTER TABLE workflow_runs ADD COLUMN engine_lease_until TEXT;\n      ALTER TABLE workflow_runs ADD COLUMN engine_lease_holder TEXT;\n    ",
-    },
-    { id: "007-unit-last-checkin", up: "\n      ALTER TABLE workflow_run_units ADD COLUMN last_checkin_at TEXT;\n    " },
-    {
-        id: "008-unit-attempts",
-        up: "\n      ALTER TABLE workflow_run_units ADD COLUMN attempts INTEGER NOT NULL DEFAULT 1;\n    ",
-    },
-    {
-        id: "009-unit-claim",
-        up: "\n      ALTER TABLE workflow_run_units ADD COLUMN claim_holder TEXT;\n      ALTER TABLE workflow_run_units ADD COLUMN claim_expires_at TEXT;\n    ",
-    },
-    {
-        id: "010-ir-v3-engine",
-        up: "\n      ALTER TABLE workflow_runs ADD COLUMN plan_ir_version INTEGER;\n      ALTER TABLE workflow_run_units ADD COLUMN engine TEXT;\n    ",
-    },
-];

package/dist/migrate/legacy/workflow-migrations-frozen.js

@@ -1,21 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Frozen `{ id, checksum }` snapshot of `WORKFLOW_MIGRATIONS` at the akm 0.9.0
- * pre-cutover HEAD. Order is significant — it is the exact ordered ledger
- * prefix that `inspectSealedMigrationLedger` asserts against a backed-up
- * `workflow.db`.
- */
-export const WORKFLOW_MIGRATIONS_CHECKSUMS = [
-    { id: "001-add-scope-key", checksum: "1147ac9875ab87fcef446ffc24f405e65d0230ab041aa160a997746f9a63fa38" },
-    { id: "002-add-agent-identity", checksum: "4fd912886ee0a54e0eb19f019bbe44e0da9344193a7ad9984d4182f74bd823c1" },
-    { id: "003-checkin-and-step-summary", checksum: "dff0184eb8f8cb5e104ea311f4816b263b96679d13d7117e0b66eab589f2f51b" },
-    { id: "004-workflow-run-units", checksum: "5b58d50274a557bf6bffdff3cfc622ed7c90b1383d44d183af3d50a30cd4970b" },
-    { id: "005-unit-session-id", checksum: "ddd01c2788f3c5fd2829fcb9349285f47f9f7245efe9382fe3819020bca823e9" },
-    { id: "006-frozen-plan-and-lease", checksum: "6df7a0079a718a9a46b88533e5f2e00baa5d9f55a0540a5ed0680c422a915eed" },
-    { id: "007-unit-last-checkin", checksum: "a839af5677548f5cb37f9ff39218aecb639e9278909386568f3f7fb4add641dc" },
-    { id: "008-unit-attempts", checksum: "a125dd744dd4eb3f5251a2e713dfdc257c4d5950b025563a8d6ea1d290da2b45" },
-    { id: "009-unit-claim", checksum: "885e2c28fca0e98e51e45e7e26d1598a6ff1a2e873a17bf6184b3dd4b6d5613c" },
-    { id: "010-ir-v3-engine", checksum: "89bd2d741b3961bebcfcf6fafc826033001954be9125585911787cff2bb8a34c" },
-];

package/dist/migrate/legacy-ref-grammar.js

@@ -1,214 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * MIGRATE HOME for the pre-0.9.0 `[origin//]type:name` ref grammar and the
- * dual-grammar bridge that keeps STORED durable refs (state.db usage events,
- * proposals, salience rows, workflow runs, index `entry_ref` rows) parseable
- * while they still carry the legacy spelling.
- *
- * Everything here retires with the Chunk-8 §11.4 one-time state.db re-key: once
- * every durable row is re-keyed to `bundle//conceptId`, the legacy grammar and
- * this whole module are deleted. Chunk-8's content-migration + §11.4 re-key
- * passes consume these functions directly.
- *
- * ── Cycle-safety (HARD constraint) ──
- *
- * Self-contained leaf: imports only sibling core leaves (`asset-ref`,
- * `asset-placement`), the `recognition-util` sink, and the `core/errors` sink.
- * It NEVER imports `resolve-ref` (the input-boundary layer), so it cannot join
- * an import cycle. The permanent D-R2 reverse table lives in `resolve-ref.ts`
- * (`typeNameFromConceptId`); this module carries its own private transient copy
- * ({@link conceptIdToLegacyParts}) for stored-ref parsing so it stays a leaf.
- */
-import path from "node:path";
-import { stashDirFor, typeForStashDir } from "../core/asset/asset-placement.js";
-import { isBundleSlug, parseBundleRef } from "../core/asset/asset-ref.js";
-import { NotFoundError, UsageError } from "../core/errors.js";
-import { DEPRECATED_REJECTED_TYPES } from "../core/recognition-util.js";
-/** Accepted spelling aliases mapping to a canonical asset type. */
-const TYPE_ALIASES = {
-    environment: "env",
-};
-// ── Construction ─────────────────────────────────────────────────────────────
-/**
- * Build a legacy ref string from components.
- *
- * Examples:
- *   makeAssetRef("script", "deploy.sh")                 → "script:deploy.sh"
- *   makeAssetRef("script", "deploy.sh", "npm:@scope/pkg")→ "npm:@scope/pkg//script:deploy.sh"
- *   makeAssetRef("skill", "code-review", "local")        → "local//skill:code-review"
- */
-export function makeAssetRef(type, name, origin) {
-    validateName(name);
-    const normalized = normalizeName(name);
-    const asset = `${type}:${normalized}`;
-    if (!origin)
-        return asset;
-    return `${origin}//${asset}`;
-}
-/**
- * Serialize a parsed {@link AssetRef} back to its canonical `[origin//]type:name`
- * string form. `refToString(parseAssetRef(s))` round-trips for any `s` that
- * `parseAssetRef` accepts.
- */
-export function refToString(ref) {
-    return makeAssetRef(ref.type, ref.name, ref.origin);
-}
-// ── Parsing ──────────────────────────────────────────────────────────────────
-function parseLegacyAssetRef(ref, allowRetiredTypes) {
-    const trimmed = ref.trim();
-    if (!trimmed)
-        throw new UsageError("Empty ref.", "MISSING_REQUIRED_ARGUMENT");
-    let origin;
-    let body = trimmed;
-    const boundary = trimmed.indexOf("//");
-    if (boundary >= 0) {
-        origin = trimmed.slice(0, boundary);
-        body = trimmed.slice(boundary + 2);
-        if (!origin)
-            throw new UsageError("Empty origin in ref.", "MISSING_REQUIRED_ARGUMENT");
-    }
-    const colon = body.indexOf(":");
-    if (colon <= 0) {
-        throw new UsageError(`Invalid ref "${trimmed}". Expected [origin//]type:name, e.g. skill:deploy or knowledge:guide.md`, "MISSING_REQUIRED_ARGUMENT");
-    }
-    const rawType = body.slice(0, colon);
-    const rawName = body.slice(colon + 1);
-    // The `vault` asset type was removed in 0.9.0. Point callers at its
-    // replacements rather than failing with a generic unknown-type error.
-    if (!allowRetiredTypes && rawType === "vault") {
-        throw new UsageError("The `vault` asset type was removed in 0.9.0 — use `env:` (whole .env config) or `secret:` (a single value).", "MISSING_REQUIRED_ARGUMENT");
-    }
-    // Type aliases: `environment:` is an accepted spelling of the canonical `env:` type.
-    const resolvedType = TYPE_ALIASES[rawType] ?? rawType;
-    // Open type token (chunk 1.5, D1.5-6): any other non-empty type is valid ref
-    // data (foreign/adapter types included) EXCEPT the deliberately-removed set.
-    if (!allowRetiredTypes && DEPRECATED_REJECTED_TYPES.has(resolvedType)) {
-        throw new UsageError(`Invalid asset type: "${rawType}".`, "MISSING_REQUIRED_ARGUMENT");
-    }
-    validateName(rawName);
-    const name = normalizeName(rawName);
-    return { type: resolvedType, name, origin: origin || undefined };
-}
-/** Parse a legacy ref string in the format `[origin//]type:name`. */
-export function parseAssetRef(ref) {
-    return parseLegacyAssetRef(ref, false);
-}
-// ── Validation (private copies — kept self-contained) ────────────────────────
-function validateName(name) {
-    if (!name)
-        throw new UsageError("Empty asset name.", "MISSING_REQUIRED_ARGUMENT");
-    if (name.includes("\0"))
-        throw new UsageError("Null byte in asset name.", "MISSING_REQUIRED_ARGUMENT");
-    if (/^[A-Za-z]:/.test(name))
-        throw new UsageError("Windows drive path in asset name.", "MISSING_REQUIRED_ARGUMENT");
-    const normalized = path.posix.normalize(name.replace(/\\/g, "/"));
-    if (path.posix.isAbsolute(normalized))
-        throw new UsageError("Absolute path in asset name.", "MISSING_REQUIRED_ARGUMENT");
-    if (normalized === ".." || normalized.startsWith("../")) {
-        throw new UsageError("Path traversal in asset name.", "MISSING_REQUIRED_ARGUMENT");
-    }
-    const segments = normalized.split("/");
-    if (segments.some((seg) => seg === "." || seg === "..")) {
-        throw new UsageError("Asset name cannot contain relative path segments.", "MISSING_REQUIRED_ARGUMENT");
-    }
-}
-function normalizeName(name) {
-    return path.posix.normalize(name.replace(/\\/g, "/"));
-}
-/**
- * Classify a raw ref string as the new `[bundle//]conceptId` grammar or the
- * pre-0.9.0 `[origin//]type:name` grammar (D-R5 charset dispatch).
- *
- * NEW grammar iff EITHER:
- *   - it has a `prefix//tail` split whose `prefix` is a LEGAL bundle slug (no
- *     `/ : . #` or whitespace) AND `tail` carries no `type:`-style colon; OR
- *   - it is a bare conceptId (no `//`, no `:`).
- *
- * LEGACY otherwise: `owner/repo//skill:x` / `npm:@scope/pkg//skill:x` have
- * ILLEGAL bundle-slug prefixes, and `local//skill:x` has a legal prefix but a
- * colon in the tail — all three land as legacy.
- */
-export function classifyRefGrammar(raw) {
-    const trimmed = raw.trim();
-    const boundary = trimmed.indexOf("//");
-    if (boundary >= 0) {
-        const prefix = trimmed.slice(0, boundary);
-        const tail = trimmed.slice(boundary + 2);
-        return isBundleSlug(prefix) && !tail.includes(":") ? "bundle" : "legacy";
-    }
-    return trimmed.includes(":") ? "legacy" : "bundle";
-}
-/**
- * D-R2 static-table translation of a legacy `type`/`name` pair to its qualified
- * conceptId `<stash-subdir>/<name>` (bare-name fallback for a foreign type with
- * no placement stash-subdir). Mirrors the indexer's conceptId derivation.
- */
-export function legacyConceptId(type, name) {
-    const stashDir = stashDirFor(type);
-    return stashDir !== undefined ? `${stashDir}/${name}` : name;
-}
-/**
- * Reverse of {@link legacyConceptId}: split a qualified conceptId
- * (`<stash-subdir>/<name>`) back to its legacy `type`/`name`, or `undefined`
- * when the leading segment is not a known stash subdir. Transient private copy
- * of the permanent `typeNameFromConceptId` (resolve-ref.ts) so this leaf stays
- * self-contained; retires with the state.db re-key.
- */
-function conceptIdToLegacyParts(conceptId) {
-    const slash = conceptId.indexOf("/");
-    if (slash <= 0)
-        return undefined;
-    const type = typeForStashDir(conceptId.slice(0, slash));
-    if (type === undefined)
-        return undefined;
-    return { type, name: conceptId.slice(slash + 1) };
-}
-/**
- * Translate a raw legacy `[origin//]type:name` ref to its {@link BundleRef}
- * spelling: conceptId via {@link legacyConceptId}, and `bundle` from the origin
- * when the origin is a legal bundle slug (a `registryId`, D-R5 rule 2). A
- * `local`/`stash`/path origin is not a stored bundle id, so it stays short.
- */
-export function legacyRefToBundleRef(raw) {
-    const parsed = parseAssetRef(raw);
-    const conceptId = legacyConceptId(parsed.type, parsed.name);
-    const bundle = parsed.origin !== undefined && parsed.origin !== "local" && parsed.origin !== "stash" && isBundleSlug(parsed.origin)
-        ? parsed.origin
-        : undefined;
-    return { bundle, conceptId };
-}
-// ── Stored-ref dual parser (Chunk-8: retire with the state.db one-time re-key) ─
-/**
- * Parse a STORED durable ref that may be written in EITHER the new
- * `[bundle//]conceptId` grammar OR the pre-0.9.0 `[origin//]type:name` grammar,
- * returning today's {@link AssetRef} value-object shape.
- *
- * Stored state (usage events, proposals, salience rows, workflow runs, index
- * `entry_ref` rows) keeps its legacy spelling until the Chunk-8 §11.4 one-time
- * re-key, so every reader that parses a durable ref must accept BOTH grammars —
- * this is the safe superset of `parseRefInput` (input boundaries are new-only).
- *
- * Mapping mirrors the pre-flip input bridge exactly:
- *   - legacy input      → historical syntax parser (including retired types).
- *   - new `conceptId`   → `type`/`name` via the D-R2 reverse table.
- *   - new `bundle`      → `origin`.
- *   - `#fragment`       → rejected (no stored ref carries one).
- */
-export function parseStoredRef(raw) {
-    if (classifyRefGrammar(raw) === "legacy") {
-        // Durable state may predate the removal of a type. Retired but structurally
-        // valid refs are expected orphans; current user input remains strict.
-        return parseLegacyAssetRef(raw, true);
-    }
-    const ref = parseBundleRef(raw);
-    if (ref.fragment !== undefined) {
-        throw new UsageError(`Export fragment "#${ref.fragment}" is not accepted here — drop it from "${raw.trim()}".`, "INVALID_FLAG_VALUE");
-    }
-    const legacy = conceptIdToLegacyParts(ref.conceptId);
-    if (legacy === undefined) {
-        throw new NotFoundError(`Unrecognized asset ref "${raw.trim()}": conceptId "${ref.conceptId}" has no known asset-type prefix.`, "ASSET_NOT_FOUND");
-    }
-    return { type: legacy.type, name: legacy.name, origin: ref.bundle };
-}

package/dist/output/shapes/distill.js

@@ -1,14 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-// Output shape registration for `akm distill <ref>` (#228). The shape is
-// simple — outcome + ids + optional payload — so `brief` strips the full
-// proposal blob, `normal` keeps the headline fields, and `full` projects
-// everything for downstream automation.
-import { shapeDistillOutput } from "./helpers.js";
-export const distillShapes = [
-    {
-        command: "distill",
-        handler: (result, detail) => shapeDistillOutput(result, detail),
-    },
-];

package/dist/output/shapes/history.js

@@ -1,11 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-// Output shape registration for `akm history` — paired with the text renderer in text.ts.
-import { shapeHistoryOutput } from "./helpers.js";
-export const historyShapes = [
-    {
-        command: "history",
-        handler: (result, detail) => shapeHistoryOutput(result, detail),
-    },
-];

package/dist/output/text/distill.js

@@ -1,6 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-// Output text formatter for `akm distill <ref>` (#228).
-import { formatDistillPlain } from "./helpers.js";
-export const distillFormatters = [{ command: "distill", handler: (r) => formatDistillPlain(r) }];

package/dist/output/text/enable-disable.js

@@ -1,8 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-import { formatToggleComponentPlain } from "./helpers.js";
-export const enableDisableFormatters = [
-    { command: "enable", handler: (r) => formatToggleComponentPlain("enable", r) },
-    { command: "disable", handler: (r) => formatToggleComponentPlain("disable", r) },
-];

package/dist/output/text/history.js

@@ -1,6 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-// Output text formatter for `akm history` — paired with the shape in shapes/history.ts.
-import { formatHistoryPlain } from "./helpers.js";
-export const historyFormatters = [{ command: "history", handler: (r) => formatHistoryPlain(r) }];