@pleri/olam-cli 0.1.201 → 0.1.204

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@pleri/olam-cli",
-  "version": "0.1.201",
+  "version": "0.1.204",
   "type": "module",
   "bin": {
     "olam": "./bin/olam.cjs"
   },
   "files": [
     "bin",
-    "dist",
+    "dist/index.js",
+    "dist/index.js.map",
+    "dist/mcp-server.js",
+    "dist/image-digests.json",
+    "dist/agent-stream",
     "hermes-bundle",
     "hooks",
     "host-cp",
-    "plugin",
     "README.md"
   ],
   "engines": {
@@ -36,7 +39,8 @@
     "test:e2e:k3d-https": "node e2e/k3d-https-e2e.spec.mjs",
     "audit:publish-deps": "node scripts/audit-publish-deps.mjs",
     "audit:cli-bundle-k8s": "node scripts/audit-cli-bundle-k8s.mjs",
-    "audit:cli-package-contents": "node scripts/audit-cli-package-contents.mjs"
+    "audit:cli-package-contents": "node scripts/audit-cli-package-contents.mjs",
+    "audit:cli-test-coverage": "node ../../scripts/audit-cli-test-coverage.mjs"
   },
   "dependencies": {
     "better-sqlite3": "^12.0.0",

package/dist/ask/checkout.d.ts

@@ -1,19 +0,0 @@
-/**
- * checkout.ts — detect whether `olam ask` is running inside an olam checkout.
- *
- * When inside a checkout, the SDK is granted read-only filesystem tools (cwd =
- * repo root) so it can pull live repo files for fresher answers. Outside a
- * checkout (npx install), the bundled knowledge pack is the only grounding.
- *
- * Detection walks up from the start dir looking for an olam-shaped repo root:
- * a directory containing BOTH `packages/host-cp` and `docs/architecture`.
- * Both markers together avoid false positives on unrelated monorepos that
- * merely have a `packages/` dir.
- */
-/**
- * Walk up from `startDir` (default cwd) to the filesystem root, returning the
- * first olam repo root found, or `null` when none. Pure relative to the
- * injected `startDir`; uses real `existsSync` for the marker checks.
- */
-export declare function findOlamCheckoutRoot(startDir?: string): string | null;
-//# sourceMappingURL=checkout.d.ts.map

package/dist/ask/checkout.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/ask/checkout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAWpF"}

package/dist/ask/checkout.js

@@ -1,40 +0,0 @@
-/**
- * checkout.ts — detect whether `olam ask` is running inside an olam checkout.
- *
- * When inside a checkout, the SDK is granted read-only filesystem tools (cwd =
- * repo root) so it can pull live repo files for fresher answers. Outside a
- * checkout (npx install), the bundled knowledge pack is the only grounding.
- *
- * Detection walks up from the start dir looking for an olam-shaped repo root:
- * a directory containing BOTH `packages/host-cp` and `docs/architecture`.
- * Both markers together avoid false positives on unrelated monorepos that
- * merely have a `packages/` dir.
- */
-import { existsSync } from 'node:fs';
-import { dirname, join, parse } from 'node:path';
-/** Returns true when `dir` looks like an olam repo root. */
-function isOlamRoot(dir) {
-    return (existsSync(join(dir, 'packages', 'host-cp')) &&
-        existsSync(join(dir, 'docs', 'architecture')));
-}
-/**
- * Walk up from `startDir` (default cwd) to the filesystem root, returning the
- * first olam repo root found, or `null` when none. Pure relative to the
- * injected `startDir`; uses real `existsSync` for the marker checks.
- */
-export function findOlamCheckoutRoot(startDir = process.cwd()) {
-    let dir = startDir;
-    const { root } = parse(dir);
-    // Bound the walk by the filesystem root to avoid an infinite loop.
-    for (;;) {
-        if (isOlamRoot(dir))
-            return dir;
-        if (dir === root)
-            return null;
-        const parent = dirname(dir);
-        if (parent === dir)
-            return null;
-        dir = parent;
-    }
-}
-//# sourceMappingURL=checkout.js.map

package/dist/ask/checkout.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../../src/ask/checkout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEjD,4DAA4D;AAC5D,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,CACL,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QAC5C,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAC9C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IACnE,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,mEAAmE;IACnE,SAAS,CAAC;QACR,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAChC,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/ask/knowledge-pack-builder.d.ts

@@ -1,72 +0,0 @@
-/**
- * knowledge-pack-builder.ts — assembles the bundled olam knowledge pack.
- *
- * The knowledge pack is a single Markdown string concatenating a curated set
- * of repo docs (README, onboarding, top-level architecture overviews) plus a
- * generated CLI command reference. It is produced at BUILD time by
- * `scripts/gen-knowledge-pack.mjs` (which calls {@link buildKnowledgePack})
- * and emitted into `src/ask/knowledge-pack.generated.ts` so the published
- * `@pleri/olam-cli` tarball ships the pack inline — no repo checkout needed
- * at runtime (the `npx` install case).
- *
- * Why a build-time pack and not runtime file reads alone: outside an olam
- * checkout (installed via `npx`) there is no repo to read, yet operators still
- * ask setup questions. The bundled pack guarantees a useful baseline answer.
- * Inside a checkout, `olam ask` ADDITIONALLY lets the SDK read live repo files
- * (via the Claude Code preset's Read/Grep tools) for fresher, precise answers.
- *
- * This module is pure: callers inject the repo root + a file reader so the
- * generator script and its unit tests share one code path (Rule 9 — the test
- * asserts the assembled shape without touching the real filesystem).
- */
-/** A doc to fold into the pack, identified by its repo-relative path. */
-export interface PackSource {
-    /** Repo-relative path, e.g. `README.md` or `docs/architecture/03-system.md`. */
-    readonly path: string;
-    /** Human label rendered as the section heading inside the pack. */
-    readonly label: string;
-    /**
-     * When true, a missing file is tolerated (skipped with a note) rather than
-     * failing the build. Used for optional overview docs that may be renamed.
-     */
-    readonly optional?: boolean;
-}
-/**
- * Curated source list. Ordered most-foundational first so truncation (if a
- * future cap is added) drops the least-essential docs last. Kept small and
- * overview-grade on purpose: the pack is the SDK system prompt, not a full
- * doc dump — bloating it wastes the operator's local-subscription tokens and
- * dilutes answer precision.
- */
-export declare const DEFAULT_PACK_SOURCES: readonly PackSource[];
-/** Signature of the file reader the builder depends on (test seam). */
-export type FileReader = (absPath: string) => string;
-/** Signature of the existence check the builder depends on (test seam). */
-export type FileExists = (absPath: string) => boolean;
-export interface BuildKnowledgePackInput {
-    /** Absolute path to the repo root the doc paths resolve against. */
-    readonly repoRoot: string;
-    /** Reads a file as UTF-8; throws if unreadable. */
-    readonly readFile: FileReader;
-    /** Returns true when the file exists + is readable. */
-    readonly fileExists: FileExists;
-    /** Override the source list (tests). Defaults to {@link DEFAULT_PACK_SOURCES}. */
-    readonly sources?: readonly PackSource[];
-    /**
-     * The CLI command reference Markdown (a `command — description` list).
-     * Injected so the generator can derive it from the live commander program
-     * while tests pass a fixed string. Optional — omitted in pure-doc tests.
-     */
-    readonly commandReference?: string;
-    /** Path joiner (test seam); defaults to POSIX join via the generator. */
-    readonly join: (root: string, rel: string) => string;
-}
-/**
- * Assemble the knowledge pack string from the curated sources + command
- * reference. Pure: no I/O of its own — all filesystem access flows through the
- * injected `readFile`/`fileExists`. Missing REQUIRED docs throw (the build
- * must fail loudly per Rule 12); missing OPTIONAL docs are skipped with an
- * inline note so the pack stays coherent.
- */
-export declare function buildKnowledgePack(input: BuildKnowledgePackInput): string;
-//# sourceMappingURL=knowledge-pack-builder.d.ts.map

package/dist/ask/knowledge-pack-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-pack-builder.d.ts","sourceRoot":"","sources":["../../src/ask/knowledge-pack-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,UAAU,EAgCrD,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AAErD,2EAA2E;AAC3E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACtD;AAUD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAwBzE"}

package/dist/ask/knowledge-pack-builder.js

@@ -1,96 +0,0 @@
-/**
- * knowledge-pack-builder.ts — assembles the bundled olam knowledge pack.
- *
- * The knowledge pack is a single Markdown string concatenating a curated set
- * of repo docs (README, onboarding, top-level architecture overviews) plus a
- * generated CLI command reference. It is produced at BUILD time by
- * `scripts/gen-knowledge-pack.mjs` (which calls {@link buildKnowledgePack})
- * and emitted into `src/ask/knowledge-pack.generated.ts` so the published
- * `@pleri/olam-cli` tarball ships the pack inline — no repo checkout needed
- * at runtime (the `npx` install case).
- *
- * Why a build-time pack and not runtime file reads alone: outside an olam
- * checkout (installed via `npx`) there is no repo to read, yet operators still
- * ask setup questions. The bundled pack guarantees a useful baseline answer.
- * Inside a checkout, `olam ask` ADDITIONALLY lets the SDK read live repo files
- * (via the Claude Code preset's Read/Grep tools) for fresher, precise answers.
- *
- * This module is pure: callers inject the repo root + a file reader so the
- * generator script and its unit tests share one code path (Rule 9 — the test
- * asserts the assembled shape without touching the real filesystem).
- */
-/**
- * Curated source list. Ordered most-foundational first so truncation (if a
- * future cap is added) drops the least-essential docs last. Kept small and
- * overview-grade on purpose: the pack is the SDK system prompt, not a full
- * doc dump — bloating it wastes the operator's local-subscription tokens and
- * dilutes answer precision.
- */
-export const DEFAULT_PACK_SOURCES = [
-    { path: 'README.md', label: 'Olam — README (overview, substrates, scope)' },
-    {
-        path: 'docs/ONBOARDING.md',
-        label: 'Onboarding (first-run, install, getting started)',
-        optional: true,
-    },
-    {
-        path: 'docs/onboarding/fresh-machine-setup.md',
-        label: 'Setup — fresh machine',
-        optional: true,
-    },
-    {
-        path: 'docs/onboarding/k3s-mode-setup.md',
-        label: 'Setup — k3d/k3s mode (default substrate, port 19001)',
-        optional: true,
-    },
-    {
-        path: 'docs/architecture/01-problem.md',
-        label: 'Architecture — the problem olam solves',
-        optional: true,
-    },
-    {
-        path: 'docs/architecture/03-system.md',
-        label: 'Architecture — system overview',
-        optional: true,
-    },
-    {
-        path: 'docs/architecture/04-lifecycle.md',
-        label: 'Architecture — world lifecycle',
-        optional: true,
-    },
-];
-/** A simple, self-describing header so the model knows what it's reading. */
-const PACK_HEADER = `# Olam knowledge pack
-
-The sections below are curated excerpts from the olam repository's own
-documentation, bundled into the CLI at build time. Treat them as the
-authoritative source for olam usage, setup, and CLI behaviour. When a section
-conflicts with your prior knowledge, the section wins.`;
-/**
- * Assemble the knowledge pack string from the curated sources + command
- * reference. Pure: no I/O of its own — all filesystem access flows through the
- * injected `readFile`/`fileExists`. Missing REQUIRED docs throw (the build
- * must fail loudly per Rule 12); missing OPTIONAL docs are skipped with an
- * inline note so the pack stays coherent.
- */
-export function buildKnowledgePack(input) {
-    const sources = input.sources ?? DEFAULT_PACK_SOURCES;
-    const parts = [PACK_HEADER];
-    for (const src of sources) {
-        const abs = input.join(input.repoRoot, src.path);
-        if (!input.fileExists(abs)) {
-            if (src.optional) {
-                parts.push(`## ${src.label}\n\n_(source \`${src.path}\` not present in this build — skipped)_`);
-                continue;
-            }
-            throw new Error(`buildKnowledgePack: required source missing: ${src.path} (resolved ${abs})`);
-        }
-        const body = input.readFile(abs).trim();
-        parts.push(`## ${src.label}\n\nSource: \`${src.path}\`\n\n${body}`);
-    }
-    if (input.commandReference && input.commandReference.trim().length > 0) {
-        parts.push(`## CLI command reference\n\n${input.commandReference.trim()}`);
-    }
-    return parts.join('\n\n---\n\n') + '\n';
-}
-//# sourceMappingURL=knowledge-pack-builder.js.map

package/dist/ask/knowledge-pack-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-pack-builder.js","sourceRoot":"","sources":["../../src/ask/knowledge-pack-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAeH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,6CAA6C,EAAE;IAC3E;QACE,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,kDAAkD;QACzD,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,wCAAwC;QAC9C,KAAK,EAAE,uBAAuB;QAC9B,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,mCAAmC;QACzC,KAAK,EAAE,sDAAsD;QAC7D,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,iCAAiC;QACvC,KAAK,EAAE,wCAAwC;QAC/C,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,gCAAgC;QACtC,KAAK,EAAE,gCAAgC;QACvC,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,mCAAmC;QACzC,KAAK,EAAE,gCAAgC;QACvC,QAAQ,EAAE,IAAI;KACf;CACF,CAAC;AA2BF,6EAA6E;AAC7E,MAAM,WAAW,GAAG;;;;;uDAKmC,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,oBAAoB,CAAC;IACtD,MAAM,KAAK,GAAa,CAAC,WAAW,CAAC,CAAC;IAEtC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,kBAAkB,GAAG,CAAC,IAAI,0CAA0C,CAAC,CAAC;gBAChG,SAAS;YACX,CAAC;YACD,MAAM,IAAI,KAAK,CACb,gDAAgD,GAAG,CAAC,IAAI,cAAc,GAAG,GAAG,CAC7E,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,iBAAiB,GAAG,CAAC,IAAI,SAAS,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,+BAA+B,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;AAC1C,CAAC"}

package/dist/ask/knowledge-pack.generated.d.ts

@@ -1,8 +0,0 @@
-/**
- * AUTO-GENERATED by scripts/gen-knowledge-pack.mjs — DO NOT EDIT BY HAND.
- *
- * The bundled olam knowledge pack used as the `olam ask` SDK system prompt.
- * Regenerate with: npm run gen:knowledge-pack --workspace=@pleri/olam-cli
- */
-export declare const KNOWLEDGE_PACK: string;
-//# sourceMappingURL=knowledge-pack.generated.d.ts.map

package/dist/ask/knowledge-pack.generated.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-pack.generated.d.ts","sourceRoot":"","sources":["../../src/ask/knowledge-pack.generated.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,cAAc,EAAE,MAizE5B,CAAC"}