@design-intelligence/ghost 0.20.0

package/dist/commands/command-discovery.js

@@ -0,0 +1,220 @@
+/**
+ * Derive a structured manifest of a built cac CLI: every command, its
+ * curated discovery metadata, and its flags. The cac registry is the single
+ * source of truth, so this can never drift from the real command definitions.
+ *
+ * Shared by the terminal help formatter's data source and the docs-site
+ * manifest dump (`scripts/dump-cli-help.mjs`) so both read one shape.
+ */
+export function buildCliManifest(cli, toolName) {
+    const commands = cli.commands.map((cmd) => {
+        const discovery = metadataFor(cmd);
+        return {
+            tool: toolName,
+            name: cmd.name,
+            rawName: cmd.rawName,
+            description: cmd.description,
+            ...(discovery
+                ? {
+                    group: discovery.group,
+                    defaultHelp: discovery.defaultHelp,
+                    compactName: discovery.compactName,
+                    summary: discovery.summary,
+                }
+                : {}),
+            options: cmd.options.map((o) => ({
+                rawName: o.rawName,
+                name: o.name,
+                description: o.description,
+                default: o.config?.default ?? null,
+                takesValue: /<[^>]+>/.test(o.rawName),
+                negated: Boolean(o.negated),
+            })),
+        };
+    });
+    const globalOptions = cli.globalCommand.options.map((o) => ({
+        rawName: o.rawName,
+        name: o.name,
+        description: o.description,
+        default: o.config?.default ?? null,
+    }));
+    return { tool: toolName, commands, globalOptions };
+}
+const GROUPS = [
+    { group: "core", title: "Core workflow" },
+    { group: "advanced", title: "Advanced/package inspection" },
+];
+const COMMAND_DISCOVERY = [
+    {
+        name: "init",
+        group: "core",
+        defaultHelp: true,
+        compactName: "init",
+        summary: "Scaffold a .ghost/ fingerprint: manifest, glossary, and a node.",
+    },
+    {
+        name: "validate",
+        group: "core",
+        defaultHelp: true,
+        compactName: "validate",
+        summary: "Validate the fingerprint: artifact shape + node validity.",
+    },
+    {
+        name: "gather",
+        group: "core",
+        defaultHelp: true,
+        compactName: "gather [ask]",
+        summary: "Emit the fingerprint menu for the agent to select from.",
+    },
+    {
+        name: "pull",
+        group: "core",
+        defaultHelp: true,
+        compactName: "pull",
+        summary: "Emit the named nodes' bodies; log the pull to .ghost/.events.",
+    },
+    {
+        name: "pulse",
+        group: "core",
+        defaultHelp: true,
+        compactName: "pulse",
+        summary: "Summarize local gather/pull events from .ghost/.events.",
+    },
+    {
+        name: "review",
+        group: "core",
+        defaultHelp: true,
+        compactName: "review",
+        summary: "Emit an advisory review packet for a diff (needs .ghost/checks/).",
+    },
+    {
+        name: "export",
+        group: "core",
+        defaultHelp: true,
+        compactName: "export",
+        summary: "Package the fingerprint as a portable brand artifact.",
+    },
+    {
+        name: "checks",
+        group: "core",
+        defaultHelp: true,
+        compactName: "checks init",
+        summary: "Scaffold .ghost/checks/ with review assertions.",
+    },
+    {
+        name: "skill",
+        group: "core",
+        defaultHelp: true,
+        compactName: "skill install",
+        summary: "Install the Ghost skill bundle.",
+    },
+    {
+        name: "manifest",
+        group: "advanced",
+        defaultHelp: false,
+        compactName: "manifest",
+        summary: "Emit a self-describing JSON manifest of commands and flags.",
+    },
+];
+const COMMAND_METADATA = COMMAND_DISCOVERY.map((entry, index) => ({
+    ...entry,
+    order: index,
+}));
+const METADATA_BY_NAME = new Map(COMMAND_METADATA.map((entry) => [entry.name, entry]));
+export function getCommandDiscoveryMetadata() {
+    return COMMAND_METADATA.map((entry) => ({ ...entry }));
+}
+export function formatGhostHelp(cli, sections) {
+    if (cli.matchedCommand)
+        return sections;
+    const baseSections = pickBaseSections(sections);
+    const showAll = Boolean(cli.options?.all);
+    const commandSections = showAll
+        ? formatAllCommandSections(cli.commands)
+        : formatDefaultCommandSections(cli.commands);
+    return [
+        baseSections.header,
+        baseSections.usage,
+        ...commandSections,
+        ...(showAll ? [formatCommandHelpSection(cli.commands, cli.name)] : []),
+        ...(showAll ? [] : [formatMoreSection()]),
+        baseSections.options,
+    ].filter(isSection);
+}
+function pickBaseSections(sections) {
+    return {
+        header: sections.find((section) => !section.title),
+        usage: sections.find((section) => section.title === "Usage"),
+        options: sections.find((section) => section.title === "Options"),
+    };
+}
+function formatDefaultCommandSections(commands) {
+    return [
+        {
+            title: "Core workflow",
+            body: formatCommandRows(commands.filter((command) => metadataFor(command)?.defaultHelp), "compact"),
+        },
+    ];
+}
+function formatAllCommandSections(commands) {
+    const grouped = GROUPS.map(({ group, title }) => ({
+        title,
+        body: formatCommandRows(commands.filter((command) => metadataFor(command)?.group === group), "raw"),
+    })).filter((section) => section.body.length > 0);
+    const unlisted = commands.filter((command) => !metadataFor(command));
+    if (unlisted.length > 0) {
+        grouped.push({
+            title: "Other",
+            body: formatCommandRows(unlisted, "raw"),
+        });
+    }
+    return grouped;
+}
+function formatCommandRows(commands, mode) {
+    const sorted = [...commands].sort(compareCommands);
+    const rows = sorted.map((command) => {
+        const metadata = metadataFor(command);
+        const displayName = mode === "compact"
+            ? (metadata?.compactName ?? command.name)
+            : command.rawName;
+        const summary = metadata?.summary ?? command.description;
+        return { displayName, summary };
+    });
+    const width = Math.max(...rows.map((row) => row.displayName.length), 0);
+    return rows
+        .map((row) => `  ${padRight(row.displayName, width)}  ${row.summary}`)
+        .join("\n");
+}
+function formatCommandHelpSection(commands, cliName) {
+    const sorted = [...commands].sort(compareCommands);
+    return {
+        title: "For command-specific help",
+        body: sorted
+            .map((command) => `  $ ${cliName} ${command.name} --help`)
+            .join("\n"),
+    };
+}
+function formatMoreSection() {
+    return {
+        title: "More",
+        body: [
+            "  $ ghost --help --all      Show all advanced commands",
+            "  $ ghost <command> --help  Show command-specific options",
+        ].join("\n"),
+    };
+}
+function compareCommands(a, b) {
+    const aOrder = metadataFor(a)?.order ?? Number.MAX_SAFE_INTEGER;
+    const bOrder = metadataFor(b)?.order ?? Number.MAX_SAFE_INTEGER;
+    return aOrder - bOrder || a.name.localeCompare(b.name);
+}
+function metadataFor(command) {
+    return METADATA_BY_NAME.get(command.name);
+}
+function padRight(value, width) {
+    return value + " ".repeat(Math.max(0, width - value.length));
+}
+function isSection(section) {
+    return Boolean(section);
+}
+//# sourceMappingURL=command-discovery.js.map

package/dist/commands/command-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-discovery.js","sourceRoot":"","sources":["../../src/commands/command-discovery.ts"],"names":[],"mappings":"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"}

package/dist/commands/errors.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Report a thrown error and exit. A `UsageError` (or anything carrying a numeric
+ * `exitCode`) exits with that code; everything else is an unexpected crash and
+ * exits `1`. Pass `stream` to match a command's existing output channel.
+ */
+export declare function failFromError(err: unknown, stream?: "stderr" | "stdout"): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/commands/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/commands/errors.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,QAAQ,GAAG,QAAmB,GACrC,KAAK,CAWP"}

package/dist/commands/errors.js

@@ -0,0 +1,19 @@
+import { EXIT } from "#ghost-core";
+/**
+ * Report a thrown error and exit. A `UsageError` (or anything carrying a numeric
+ * `exitCode`) exits with that code; everything else is an unexpected crash and
+ * exits `1`. Pass `stream` to match a command's existing output channel.
+ */
+export function failFromError(err, stream = "stderr") {
+    const message = err instanceof Error ? err.message : String(err);
+    const line = `Error: ${message}\n`;
+    if (stream === "stdout")
+        process.stdout.write(line);
+    else
+        process.stderr.write(line);
+    const exitCode = typeof err?.exitCode === "number"
+        ? err.exitCode
+        : EXIT.failure;
+    process.exit(exitCode);
+}
+//# sourceMappingURL=errors.js.map

package/dist/commands/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/commands/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAY,EACZ,SAA8B,QAAQ;IAEtC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,UAAU,OAAO,IAAI,CAAC;IACnC,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;;QAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEhC,MAAM,QAAQ,GACZ,OAAQ,GAA8B,EAAE,QAAQ,KAAK,QAAQ;QAC3D,CAAC,CAAE,GAA4B,CAAC,QAAQ;QACxC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC"}

package/dist/commands/export-command.d.ts

@@ -0,0 +1,3 @@
+import type { CAC } from "cac";
+export declare function registerExportCommand(cli: CAC): void;
+//# sourceMappingURL=export-command.d.ts.map

package/dist/commands/export-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-command.d.ts","sourceRoot":"","sources":["../../src/commands/export-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AA2C/B,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAsGpD"}

package/dist/commands/export-command.js

@@ -0,0 +1,157 @@
+import { mkdir } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { classifyMaterialLocator, resolveLocalMaterialLocator, } from "#ghost-core";
+import { lintFingerprintPackage, resolveFingerprintPackage, } from "../fingerprint.js";
+import { readPackageVersion } from "../package-version.js";
+import { GHOST_CHECKS_DIR } from "../scan/check-files.js";
+import { GHOST_EVENTS_FILENAME, GHOST_MATERIALS_DIR, } from "../scan/constants.js";
+import { loadFingerprintPackage, } from "../scan/fingerprint-package.js";
+import { resolveGitRoot } from "../scan/package-paths.js";
+import { defaultArchiveName, writeDirectoryTarball } from "../scan/tarball.js";
+import { failFromError } from "./errors.js";
+const EXPORT_SCHEMA = "ghost.export/v1";
+export function registerExportCommand(cli) {
+    cli
+        .command("export", "Package the fingerprint as a portable brand artifact with a locator audit.")
+        .option("--out <path>", "Write the archive to this path")
+        .option("--no-checks", "Exclude the checks/ directory from the archive")
+        .option("--strict", "Exit 2 if any referenced local material locators will not travel")
+        .option("--package <dir>", "Use this fingerprint package directory (default: ./.ghost)")
+        .option("--format <fmt>", "Output format: markdown or json", {
+        default: "markdown",
+    })
+        .action(async (opts) => {
+        try {
+            if (opts.format !== "markdown" && opts.format !== "json") {
+                console.error("Error: --format must be 'markdown' or 'json'");
+                process.exit(2);
+                return;
+            }
+            const paths = resolveFingerprintPackage(opts.package, process.cwd());
+            const report = await lintFingerprintPackage(opts.package, process.cwd());
+            if (report.errors > 0) {
+                console.error("Error: fingerprint package has validation errors. Run `ghost validate` and fix them before exporting.");
+                process.exit(2);
+                return;
+            }
+            const loaded = await loadFingerprintPackage(paths);
+            const archive = typeof opts.out === "string"
+                ? resolve(process.cwd(), opts.out)
+                : resolve(process.cwd(), defaultArchiveName(loaded.manifest.id));
+            const exported = new Date().toISOString();
+            await mkdir(dirname(archive), { recursive: true });
+            await writeDirectoryTarball({
+                rootDir: paths.packageDir,
+                outFile: archive,
+                extraEntries: [
+                    {
+                        path: "export.yml",
+                        data: formatExportManifest({
+                            id: loaded.manifest.id,
+                            cli: readPackageVersion(),
+                            exported,
+                        }),
+                        mtime: new Date(exported),
+                    },
+                ],
+                exclude: (relativePath) => relativePath === GHOST_EVENTS_FILENAME ||
+                    (opts.checks === false &&
+                        (relativePath === GHOST_CHECKS_DIR ||
+                            relativePath.startsWith(`${GHOST_CHECKS_DIR}/`))),
+            });
+            const repoRoot = await resolveGitRoot(process.cwd());
+            const audit = buildExportAudit(loaded, {
+                repoRoot,
+                packageDir: paths.packageDir,
+            });
+            if (opts.format === "json") {
+                process.stdout.write(`${JSON.stringify({
+                    kind: "export",
+                    archive,
+                    id: loaded.manifest.id,
+                    audit,
+                }, null, 2)}\n`);
+            }
+            else {
+                process.stdout.write(formatExportMarkdown({
+                    archive,
+                    id: loaded.manifest.id,
+                    audit,
+                }));
+            }
+            process.exit(opts.strict && audit.stranded.length > 0 ? 2 : 0);
+        }
+        catch (err) {
+            failFromError(err);
+        }
+    });
+}
+function buildExportAudit(loaded, options) {
+    const travels = [];
+    const stranded = [];
+    for (const node of loaded.catalog.nodes.values()) {
+        auditNodeMaterials(node, options, travels, stranded);
+    }
+    return { travels, stranded };
+}
+function auditNodeMaterials(node, options, travels, stranded) {
+    for (const locator of node.materials ?? []) {
+        const classified = classifyMaterialLocator(locator);
+        if (classified.kind === "url") {
+            travels.push({ nodeId: node.id, locator, tier: "url" });
+            continue;
+        }
+        const resolved = resolveLocalMaterialLocator(locator, {
+            repoRoot: options.repoRoot,
+            packageDir: options.packageDir,
+            materialsDir: GHOST_MATERIALS_DIR,
+        });
+        if (resolved.tier === "bundled") {
+            travels.push({ nodeId: node.id, locator, tier: "bundled" });
+        }
+        else {
+            stranded.push({ nodeId: node.id, locator });
+        }
+    }
+}
+function formatExportManifest(fields) {
+    return [
+        `schema: ${EXPORT_SCHEMA}`,
+        `id: ${fields.id}`,
+        `cli: ${fields.cli}`,
+        `exported: ${fields.exported}`,
+        "",
+    ].join("\n");
+}
+function formatExportMarkdown(fields) {
+    const lines = [
+        "# Ghost Export",
+        "",
+        `Archive: \`${fields.archive}\``,
+        `Fingerprint: \`${fields.id}\``,
+        "",
+        "## Locator audit",
+        "",
+    ];
+    if (fields.audit.travels.length > 0) {
+        lines.push("Travels with the archive:", "");
+        for (const item of fields.audit.travels) {
+            const label = item.tier === "url" ? "HTTPS URL" : "bundled material";
+            lines.push(`- \`${item.nodeId}\` — \`${item.locator}\` (${label})`);
+        }
+    }
+    else {
+        lines.push("Travels with the archive: none.");
+    }
+    lines.push("", "Will not travel:", "");
+    if (fields.audit.stranded.length > 0) {
+        for (const item of fields.audit.stranded) {
+            lines.push(`- \`${item.nodeId}\` — \`${item.locator}\``, "  - Bundle it into `.ghost/materials/` or accept the gap.");
+        }
+    }
+    else {
+        lines.push("- No referenced local material locators are stranded.");
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=export-command.js.map

package/dist/commands/export-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-command.js","sourceRoot":"","sources":["../../src/commands/export-command.ts"],"names":[],"mappings":"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"}

package/dist/commands/fingerprint-commands.d.ts

@@ -0,0 +1,10 @@
+import type { CAC } from "cac";
+/**
+ * Register fingerprint package commands on the unified Ghost CLI.
+ *
+ * Verbs author and validate the root `.ghost/` fingerprint package: `init`
+ * (scaffold) and `validate` (manifest shape, node validity, material locators,
+ * check references, and glossary kind prefixes).
+ */
+export declare function registerFingerprintCommands(cli: CAC): void;
+//# sourceMappingURL=fingerprint-commands.d.ts.map

package/dist/commands/fingerprint-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-commands.d.ts","sourceRoot":"","sources":["../../src/commands/fingerprint-commands.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAW/B;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA4C1D"}

package/dist/commands/fingerprint-commands.js

@@ -0,0 +1,74 @@
+import { readFile, stat } from "node:fs/promises";
+import { resolve } from "node:path";
+import { lintFingerprintPackage, resolveFingerprintPackage, } from "../fingerprint.js";
+import { detectFileKind, lintDetectedFileKind } from "../scan/file-kind.js";
+import { resolveGhostDirDefault } from "../scan/index.js";
+import { failFromError } from "./errors.js";
+import { registerInitCommand } from "./init-command.js";
+/**
+ * Register fingerprint package commands on the unified Ghost CLI.
+ *
+ * Verbs author and validate the root `.ghost/` fingerprint package: `init`
+ * (scaffold) and `validate` (manifest shape, node validity, material locators,
+ * check references, and glossary kind prefixes).
+ */
+export function registerFingerprintCommands(cli) {
+    // --- validate (shape pass + catalog pass) ---
+    cli
+        .command("validate [file]", "Validate the Ghost fingerprint package — manifest shape, node validity, material locators, check references, and glossary kind prefixes. Defaults to .ghost.")
+        .option("--package <dir>", "Use this fingerprint package directory (default: ./.ghost)")
+        .option("--format <fmt>", "Output format: cli or json", { default: "cli" })
+        .action(async (path, opts) => {
+        try {
+            const ghostDir = ghostDirFromEnv();
+            const exactPackage = typeof opts.package === "string" ? opts.package : undefined;
+            const packagePath = exactPackage ?? path ?? ghostDir;
+            const target = resolveFingerprintPackage(packagePath, process.cwd()).dir;
+            let report;
+            if (path === undefined || (await isDirectory(target))) {
+                report = await lintFingerprintPackage(packagePath, process.cwd());
+                writeLintReport(report, opts.format);
+                process.exit(report.errors > 0 ? 1 : 0);
+                return;
+            }
+            const fileTarget = resolve(process.cwd(), path ?? target);
+            const raw = await readFile(fileTarget, "utf-8");
+            const kind = detectFileKind(fileTarget, raw);
+            report = lintDetectedFileKind(kind, raw);
+            writeLintReport(report, opts.format);
+            process.exit(report.errors > 0 ? 1 : 0);
+        }
+        catch (err) {
+            failFromError(err);
+        }
+    });
+    registerInitCommand(cli);
+}
+function ghostDirFromEnv() {
+    return resolveGhostDirDefault();
+}
+function writeLintReport(report, format) {
+    if (format === "json") {
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        return;
+    }
+    for (const issue of report.issues) {
+        const prefix = issue.severity === "error"
+            ? "ERROR"
+            : issue.severity === "warning"
+                ? "WARN "
+                : "INFO ";
+        const pathSuffix = issue.path ? ` @ ${issue.path}` : "";
+        process.stdout.write(`${prefix} [${issue.rule}] ${issue.message}${pathSuffix}\n`);
+    }
+    process.stdout.write(`\n${report.errors} error(s), ${report.warnings} warning(s), ${report.info} info\n`);
+}
+async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fingerprint-commands.js.map

package/dist/commands/fingerprint-commands.js.map

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

package/dist/commands/gather-command.d.ts

@@ -0,0 +1,3 @@
+import type { CAC } from "cac";
+export declare function registerGatherCommand(cli: CAC): void;
+//# sourceMappingURL=gather-command.d.ts.map

package/dist/commands/gather-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gather-command.d.ts","sourceRoot":"","sources":["../../src/commands/gather-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAsB/B,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA4EpD"}