@design-intelligence/ghost 0.20.0

package/dist/scan/lint.d.ts

@@ -0,0 +1,15 @@
+export type LintSeverity = "error" | "warning" | "info";
+export interface LintIssue {
+    severity: LintSeverity;
+    rule: string;
+    message: string;
+    /** Dotted path in the file (e.g. "intent.principles[0].evidence"). */
+    path?: string;
+}
+export interface LintReport {
+    issues: LintIssue[];
+    errors: number;
+    warnings: number;
+    info: number;
+}
+//# sourceMappingURL=lint.d.ts.map

package/dist/scan/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/scan/lint.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/scan/lint.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lint.js.map

package/dist/scan/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/scan/lint.ts"],"names":[],"mappings":""}

package/dist/scan/node-files.d.ts

@@ -0,0 +1,25 @@
+import { type PlacedNode } from "#ghost-core";
+export interface LoadedNodeFiles {
+    nodes: PlacedNode[];
+    /** Files that failed lint, with their first error message (path-relative id). */
+    invalid: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/**
+ * Load authored prose nodes from the package directory. The corpus is flat:
+ * there is no hierarchy, no inheritance, no edges. Nesting into directories is a
+ * browsing convenience only.
+ *
+ * Every `*.md` file under the package directory is a node. Its id is its path
+ * with `.md` dropped, uniformly (`marketing/email.md` → `marketing/email`,
+ * `index.md` → `index`). The reserved root entries — `manifest.yml`,
+ * `glossary.md`, `materials/`, and `checks/` — are skipped.
+ *
+ * A file that fails per-node lint is collected in `invalid` (with its first
+ * error) and skipped rather than throwing, so one bad node does not block
+ * loading the rest. A missing package directory or empty corpus yields no nodes.
+ */
+export declare function loadNodeFiles(packageDir: string): Promise<LoadedNodeFiles>;
+//# sourceMappingURL=node-files.d.ts.map

package/dist/scan/node-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-files.d.ts","sourceRoot":"","sources":["../../src/scan/node-files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAa,MAAM,aAAa,CAAC;AAuBzD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,iFAAiF;IACjF,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAU1B"}

package/dist/scan/node-files.js

@@ -0,0 +1,114 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parseNode } from "#ghost-core";
+import { FINGERPRINT_MANIFEST_FILENAME, GHOST_GLOSSARY_FILENAME, GHOST_MATERIALS_DIR, } from "./constants.js";
+/**
+ * Reserved package-root entries that are never nodes: the manifest (the
+ * package anchor), the glossary, `materials/` (bundled materials), and
+ * `checks/` (review checks — feed-back only, never generation context). The
+ * list is closed. `haunts/` is the legacy pre-flat checks location, kept
+ * reserved so stale packages do not misload its contents as nodes.
+ */
+const RESERVED_ROOT_ENTRIES = new Set([
+    FINGERPRINT_MANIFEST_FILENAME,
+    "manifest.yaml",
+    GHOST_GLOSSARY_FILENAME,
+    GHOST_MATERIALS_DIR,
+    "checks",
+    "haunts",
+]);
+/**
+ * Load authored prose nodes from the package directory. The corpus is flat:
+ * there is no hierarchy, no inheritance, no edges. Nesting into directories is a
+ * browsing convenience only.
+ *
+ * Every `*.md` file under the package directory is a node. Its id is its path
+ * with `.md` dropped, uniformly (`marketing/email.md` → `marketing/email`,
+ * `index.md` → `index`). The reserved root entries — `manifest.yml`,
+ * `glossary.md`, `materials/`, and `checks/` — are skipped.
+ *
+ * A file that fails per-node lint is collected in `invalid` (with its first
+ * error) and skipped rather than throwing, so one bad node does not block
+ * loading the rest. A missing package directory or empty corpus yields no nodes.
+ */
+export async function loadNodeFiles(packageDir) {
+    const nodes = [];
+    const invalid = [];
+    await walk(packageDir, "", true, nodes, invalid);
+    // Deterministic order by id, mirroring the old sorted readdir.
+    nodes.sort((a, b) => a.id.localeCompare(b.id));
+    invalid.sort((a, b) => a.file.localeCompare(b.file));
+    return { nodes, invalid };
+}
+async function walk(packageDir, relDir, isRoot, nodes, invalid) {
+    const absDir = relDir === "" ? packageDir : join(packageDir, relDir);
+    let entries;
+    try {
+        const dirents = await readdir(absDir, { withFileTypes: true });
+        entries = dirents.map((d) => ({ name: d.name, isDir: d.isDirectory() }));
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (isRoot && RESERVED_ROOT_ENTRIES.has(entry.name))
+            continue;
+        if (entry.name.startsWith("."))
+            continue;
+        const relPath = relDir === "" ? entry.name : `${relDir}/${entry.name}`;
+        if (entry.isDir) {
+            await walk(packageDir, relPath, false, nodes, invalid);
+            continue;
+        }
+        if (!entry.name.endsWith(".md"))
+            continue;
+        const raw = await readFile(join(packageDir, relPath), "utf-8");
+        const { node, report } = parseNode(raw);
+        if (node === null || report.errors > 0) {
+            const first = report.issues.find((issue) => issue.severity === "error");
+            invalid.push({
+                file: relPath,
+                message: first?.message ?? "invalid node",
+            });
+            continue;
+        }
+        const { id, kind, slug } = locate(relPath);
+        nodes.push({
+            id,
+            ...(kind !== undefined ? { kind } : {}),
+            slug,
+            doc: node,
+        });
+    }
+}
+/**
+ * Compute a node's id and filename kind/slug from its package-relative path.
+ *
+ * The rule is uniform: the **id** is the path with `.md` dropped. The **kind**
+ * is the leaf filename's first dotted segment, and only exists when the leaf
+ * has a dot; the **slug** is the rest of the leaf. A kind never changes a
+ * node's identity path. `index.md` is an ordinary node with id `index` — by
+ * convention the human-curated front door, but nothing special to the loader.
+ * - `index.md`               → id `index`,             slug `index` (no kind).
+ * - `voice.md`               → id `voice`,             slug `voice` (no kind).
+ * - `principle.density.md`   → id `principle.density`, kind `principle`, slug `density`.
+ * - `a/principle.trust.md`   → id `a/principle.trust`, kind `principle`, slug `trust`.
+ */
+function locate(relPath) {
+    const withoutExt = relPath.replace(/\.md$/, "");
+    const segments = withoutExt.split("/");
+    const leaf = segments[segments.length - 1] ?? "";
+    const id = withoutExt;
+    // A dotted leaf splits into kind (first segment) and slug (the remainder);
+    // a bare leaf is all slug with no kind.
+    const dot = leaf.indexOf(".");
+    if (dot > 0) {
+        return {
+            id,
+            kind: leaf.slice(0, dot),
+            slug: leaf.slice(dot + 1),
+        };
+    }
+    return { id, slug: leaf };
+}
+//# sourceMappingURL=node-files.js.map

package/dist/scan/node-files.js.map

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

package/dist/scan/package-paths.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Neutral home for the load-bearing package-path helpers: direct package
+ * addressing (no nesting machinery), consumed by fingerprint-commands,
+ * init-command, monorepo-init-command, and the scan/index re-exports.
+ */
+export declare function resolveGitRoot(cwd?: string): Promise<string>;
+export declare function normalizeGhostDir(ghostDir?: string): string;
+export declare const GHOST_PACKAGE_DIR_ENV = "GHOST_PACKAGE_DIR";
+export declare function resolveGhostDirDefault(explicitGhostDir?: unknown, env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=package-paths.d.ts.map

package/dist/scan/package-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-paths.d.ts","sourceRoot":"","sources":["../../src/scan/package-paths.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AAEH,wBAAsB,cAAc,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAazE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,SAA0B,GAAG,MAAM,CA2B5E;AAED,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAEzD,wBAAgB,sBAAsB,CACpC,gBAAgB,CAAC,EAAE,OAAO,EAC1B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAMR"}

package/dist/scan/package-paths.js

@@ -0,0 +1,49 @@
+import { execFile } from "node:child_process";
+import { isAbsolute, resolve } from "node:path";
+import { promisify } from "node:util";
+import { UsageError } from "#ghost-core";
+import { FINGERPRINT_PACKAGE_DIR } from "./constants.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Neutral home for the load-bearing package-path helpers: direct package
+ * addressing (no nesting machinery), consumed by fingerprint-commands,
+ * init-command, monorepo-init-command, and the scan/index re-exports.
+ */
+export async function resolveGitRoot(cwd = process.cwd()) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--show-toplevel"], {
+            cwd,
+        });
+        return resolve(stdout.trim());
+    }
+    catch {
+        return resolve(cwd);
+    }
+}
+export function normalizeGhostDir(ghostDir = FINGERPRINT_PACKAGE_DIR) {
+    const normalized = ghostDir
+        .trim()
+        .replaceAll("\\", "/")
+        .replace(/\/+/g, "/")
+        .replace(/\/$/g, "");
+    if (!normalized) {
+        throw new UsageError("GHOST_PACKAGE_DIR must not be empty");
+    }
+    if (isAbsolute(ghostDir) ||
+        normalized.startsWith("/") ||
+        /^[A-Za-z]:/.test(normalized)) {
+        throw new UsageError("GHOST_PACKAGE_DIR must be a relative directory path");
+    }
+    const segments = normalized.split("/");
+    if (segments.some((segment) => segment === "." || segment === ".." || segment === "")) {
+        throw new UsageError("GHOST_PACKAGE_DIR must not contain '.', '..', or empty path segments");
+    }
+    return normalized;
+}
+export const GHOST_PACKAGE_DIR_ENV = "GHOST_PACKAGE_DIR";
+export function resolveGhostDirDefault(explicitGhostDir, env = process.env) {
+    return normalizeGhostDir(typeof explicitGhostDir === "string"
+        ? explicitGhostDir
+        : env[GHOST_PACKAGE_DIR_ENV]);
+}
+//# sourceMappingURL=package-paths.js.map

package/dist/scan/package-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-paths.js","sourceRoot":"","sources":["../../src/scan/package-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;;GAIG;AAEH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACtD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,KAAK,EACL,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAChC;YACE,GAAG;SACJ,CACF,CAAC;QACF,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAQ,GAAG,uBAAuB;IAClE,MAAM,UAAU,GAAG,QAAQ;SACxB,IAAI,EAAE;SACN,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;IAC9D,CAAC;IACD,IACE,UAAU,CAAC,QAAQ,CAAC;QACpB,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAC1B,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAC7B,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,qDAAqD,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,IACE,QAAQ,CAAC,IAAI,CACX,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,EAAE,CACnE,EACD,CAAC;QACD,MAAM,IAAI,UAAU,CAClB,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,MAAM,UAAU,sBAAsB,CACpC,gBAA0B,EAC1B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,iBAAiB,CACtB,OAAO,gBAAgB,KAAK,QAAQ;QAClC,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAC/B,CAAC;AACJ,CAAC"}

package/dist/scan/steering-template.d.ts

@@ -0,0 +1,8 @@
+import type { GhostInitTemplate, TemplateFile } from "./templates.js";
+interface SteeringTemplateDeps {
+    manifestFile(): TemplateFile;
+    gitignoreFile(): TemplateFile;
+}
+export declare function createSteeringTemplate({ manifestFile, gitignoreFile, }: SteeringTemplateDeps): GhostInitTemplate;
+export {};
+//# sourceMappingURL=steering-template.d.ts.map

package/dist/scan/steering-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering-template.d.ts","sourceRoot":"","sources":["../../src/scan/steering-template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtE,UAAU,oBAAoB;IAC5B,YAAY,IAAI,YAAY,CAAC;IAC7B,aAAa,IAAI,YAAY,CAAC;CAC/B;AAED,wBAAgB,sBAAsB,CAAC,EACrC,YAAY,EACZ,aAAa,GACd,EAAE,oBAAoB,GAAG,iBAAiB,CAE1C"}

package/dist/scan/steering-template.js

@@ -0,0 +1,266 @@
+export function createSteeringTemplate({ manifestFile, gitignoreFile, }) {
+    return STEERING_TEMPLATE_FACTORY(manifestFile, gitignoreFile);
+}
+/**
+ * Steering starter: named truths for pre-generation steering. The extra kinds
+ * are vocabulary only: no schema or selection behavior changes.
+ */
+function STEERING_TEMPLATE_FACTORY(manifestFile, gitignoreFile) {
+    return {
+        name: "steering",
+        description: "Steering starter: stance, patterns, exemplars, materials.",
+        files() {
+            return [
+                manifestFile(),
+                gitignoreFile(),
+                {
+                    relativePath: "glossary.md",
+                    content: `---
+kinds:
+  - name: principle
+  - name: condition
+  - name: pattern
+  - name: exemplar
+  - name: anti-goal
+    posture: guard
+  - name: asset
+  - name: decision
+  - name: concept
+#  - { name: provocation, posture: wild, purpose: a deliberate provocation past the fingerprint — surfaced only on request }
+---
+
+# principle
+
+Durable stance, tradeoff, or invariant. Patterns may narrow principles, never loosen them.
+
+# condition
+
+Situational truth. Use only when the stated situation holds.
+
+# pattern
+
+Reusable composition. State what is bound, what is open, and when it applies.
+
+# exemplar
+
+Concrete reference for form, rhythm, quality, code shape, voice, or behavior. Say what to copy and not copy.
+
+# anti-goal
+
+Review-critical guard posture. State not-X-instead-Y: the rejected default, the positive replacement, and how to recognize the switch.
+
+# asset
+
+Material truth about concrete assets, tokens, components, type, motion, imagery, code, or files. \`materials\` locates; prose explains.
+
+# decision
+
+Worked tradeoff trace: what was chosen, what was rejected, and why.
+
+# concept
+
+Scoped creative direction for a specific output; not permanent brand law.
+`,
+                },
+                {
+                    relativePath: "index.md",
+                    content: `---
+description: Always read first — the steering front door, non-negotiables, and silence posture.
+---
+
+This fingerprint is demo content for **Morrow Ledger**, a small bookkeeping product for independent studios. It steers agent-generated product and brand work; it is not a component API or complete archive.
+
+## Before you trust this fingerprint
+
+Everything in this starter package is demo content. It is intentionally opinionated so you can see the shape of useful steering: hard truths, refusal lines, material locators, patterns, exemplars, and tradeoff traces. Keep any structure that helps, but replace the claims, paths, examples, and decisions with real product truth before using this fingerprint to guide generation.
+
+## Non-negotiables
+
+The lines below are demo non-negotiables for inspiration and guidance. Replace them with your real hard truths:
+
+- Morrow Ledger sounds like a careful bookkeeper, not a growth coach.
+- Use slate ink, ledger green, and quiet amber before inventing new color.
+- Preserve the composition floor in \`principle.composition\`.
+- Avoid the generic generated defaults named in \`anti-goal.*\`.
+- Label provisional reasoning when this fingerprint is silent.
+
+## How to read the corpus
+
+\`principle.*\` gives stance and hard floor. \`pattern.*\` gives bound/open structure. \`exemplar.*\` shows form and quality. \`anti-goal.*\` names likely wrong outputs. \`asset.*\` points to materials. \`decision.*\` explains tradeoffs. \`concept.*\` is scoped direction, not law. The starter nodes are teaching examples, not defaults Ghost believes about your brand.
+
+## Silence posture
+
+When this fingerprint is silent, proceed provisionally from local conventions only when safe. Ask before brand-defining, irreversible, legal, privacy-sensitive, or high-risk choices.
+`,
+                },
+                {
+                    relativePath: "principle.stance.md",
+                    content: `---
+description: Core stance and tradeoffs — gather when a task needs brand decision-making beyond exact materials.
+---
+
+Morrow Ledger helps independent studios know what changed in their money without making finance feel like a performance dashboard.
+
+Forced choices:
+
+- **Clarity beats momentum.** When a line could sound exciting or precise, choose precise. Write "3 invoices are 14+ days late" instead of "Cash flow needs attention."
+- **Evidence beats reassurance.** Pair every claim with the number, date, file, or account behind it. Never say "all set" unless the surface shows what was checked.
+- **Calm beats clever.** Use plain verbs: sent, due, matched, missing, paid. Avoid pep-talk verbs: crush, unlock, supercharge.
+- **Small business time is scarce.** Lead with the next accountable action and its cost: "Review 2 unmatched deposits — about 4 minutes."
+
+The brand earns trust by making the boring truth easy to act on. If the work feels motivational, it is drifting.
+
+`,
+                },
+                {
+                    relativePath: "principle.composition.md",
+                    content: `---
+description: Composition floor — hard layout invariants that hold whether or not a pattern matches the ask.
+---
+
+These demo invariants show the kind of floor that steers generation. Replace them with real hard lines that apply to every generated surface unless a narrower condition explicitly says otherwise. Patterns narrow them; nothing loosens them.
+
+For Morrow Ledger:
+
+- **One ledger fact leads.** Every surface opens with one factual sentence or number. If two facts compete, choose the one that changes what the user does next.
+- **Maximum three figures above the fold.** A figure is any amount, count, date, or percentage. If there are four, demote one into details instead of shrinking type.
+- **Actions are accountable verbs.** Primary actions begin with Review, Match, Send, Export, or Mark. Never use generic "Continue" when the action can be named.
+- **Whitespace before boxes.** Separate sections with 24px vertical space first, a 1px #D8DED8 rule second, and a card only when the content has its own state.
+
+Token sketch for demos:
+
+\`\`\`css
+:root {
+  --morrow-ink: #17201b;
+  --morrow-ledger: #2f6f4f;
+  --morrow-amber: #b7791f;
+  --morrow-paper: #f7f5ef;
+}
+\`\`\`
+
+`,
+                },
+                {
+                    relativePath: "anti-goal.generic-generated-output.md",
+                    content: `---
+description: The generic generated output this fingerprint rejects.
+---
+
+This is demo anti-goal content. Replace it with the defaults this brand actually refuses.
+
+Not: a rounded-card SaaS dashboard full of gradients, celebratory deltas, and "You're crushing it" copy.
+
+Instead: a ledger-first surface with one leading fact, muted paper background, accountable next action, and evidence close to the claim.
+
+Concrete replacements:
+
+- Not "Revenue is up 24% 🎉" — instead "July receipts are $4,820 higher than June; 2 invoices explain most of the change."
+- Not a decorative blob or fake chart preview — instead a compact list of the source transactions or invoices.
+- Not "Oops, something went wrong" — instead "We could not match deposit 1042. Choose the invoice or mark it as owner contribution."
+
+A technically correct output can still be off-brand if any product could ship it. This guard is review-critical because generic finance optimism is the most likely model default.
+`,
+                },
+                {
+                    relativePath: "pattern.status-with-next-step.md",
+                    content: `---
+description: Status of an ongoing thing plus the single next step — use when the task asks where something stands or what happens next.
+---
+
+This is a demo pattern for inspiration and guidance. Replace it with a real reusable pattern from your product.
+
+Applies when the surface explains the state of something in flight: invoice payment, bank sync, export, tax packet, or reconciliation.
+
+**Bound (do not redecide):**
+
+- Status line first, exactly one sentence, no more than 11 words.
+- One evidence row with amount, date, and source.
+- One primary next step last, beginning with an accountable verb.
+
+**Open (within limits):**
+
+- Evidence may be a table row or two-item list.
+- Use amber only for a user action needed within 7 days.
+
+## Skeleton
+
+\`\`\`tsx
+<section className="morrow-status">
+  <p className="eyebrow">{scope}</p>
+  <h1>{statusSentence}</h1>
+  <p>{meaningSentence}</p>
+  <dl>{amountDateSource}</dl>
+  <button>{accountableNextStep}</button>
+</section>
+\`\`\`
+
+`,
+                },
+                {
+                    relativePath: "exemplar.annotated-reference.md",
+                    content: `---
+description: Annotated reference — replace with a sample that shows form, rhythm, quality, voice, or code shape.
+materials:
+  - src/components/status-card.tsx
+---
+
+This is demo exemplar content. Replace \`src/components/status-card.tsx\` with a real screenshot, file, URL, or implementation path.
+
+Normative for: density, evidence placement, accountable action language.
+
+Annotated reference:
+
+\`\`\`tsx
+<aside className="rounded-none border-l border-[#D8DED8] bg-[#F7F5EF] p-6 text-[#17201B]">
+  <p className="text-xs uppercase tracking-[0.14em] text-[#2F6F4F]">Bank sync</p>
+  <h2 className="mt-3 text-2xl font-semibold">3 deposits need matching</h2>
+  <p className="mt-2 max-w-prose text-sm">They total $8,410 and arrived between Jul 12 and Jul 15.</p>
+  <button className="mt-6 border border-[#17201B] px-4 py-2 text-sm">Match deposits — about 4 minutes</button>
+</aside>
+\`\`\`
+
+Copy the square edge, measured evidence, and action cost. Do not copy the exact amounts or dates.
+`,
+                },
+                {
+                    relativePath: "asset.materials.md",
+                    content: `---
+description: Concrete materials the agent should inspect before inventing visual language, components, type, motion, or assets.
+materials:
+  - src/styles/tokens.css
+  - src/components/**
+  - public/brand/**
+---
+
+This is demo material inventory. Replace the paths with real tokens, components, SVGs, motion specs, images, or implementations.
+
+Morrow Ledger's starter materials should resolve to real files in your repo before use:
+
+- \`src/styles/tokens.css\` should define the ink, ledger, amber, paper, and rule colors.
+- \`src/components/**\` should include the production Button, InlineAlert, and DataRow components.
+- \`public/brand/**\` should include the wordmark and any blessed product screenshots.
+
+Use this node to locate real materials. \`materials\` points to concrete files; this prose explains what they mean. Do not duplicate API docs unless the API itself is the brand truth.
+`,
+                },
+                {
+                    relativePath: "decision.tradeoff.md",
+                    content: `---
+description: Worked tradeoff — replace with a decision where the brand chose between plausible options.
+---
+
+This is demo decision content. Replace it with a real tradeoff that helps an agent decide between plausible good answers.
+
+Morrow Ledger tradeoff: we chose visible evidence over shorter surfaces.
+
+- Option A: a compact success banner, "Bank sync complete." It was calm and fast, but it hid what changed.
+- Option B: a slightly taller status block, "Bank sync complete; 14 transactions imported since Jul 12." It costs one extra line but gives the user a fact to trust.
+- Decision: choose Option B whenever the action touches money, taxes, invoices, exports, or bank data.
+- Reverses when: the evidence would expose sensitive third-party details in a shared view. Then show the count only and link to details.
+`,
+                },
+            ];
+        },
+    };
+}
+//# sourceMappingURL=steering-template.js.map

package/dist/scan/steering-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering-template.js","sourceRoot":"","sources":["../../src/scan/steering-template.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,sBAAsB,CAAC,EACrC,YAAY,EACZ,aAAa,GACQ;IACrB,OAAO,yBAAyB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB,CAChC,YAAgC,EAChC,aAAiC;IAEjC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,2DAA2D;QACxE,KAAK;YACH,OAAO;gBACL,YAAY,EAAE;gBACd,aAAa,EAAE;gBACf;oBACE,YAAY,EAAE,aAAa;oBAC3B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6ClB;iBACQ;gBACD;oBACE,YAAY,EAAE,UAAU;oBACxB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BlB;iBACQ;gBACD;oBACE,YAAY,EAAE,qBAAqB;oBACnC,OAAO,EAAE;;;;;;;;;;;;;;;CAelB;iBACQ;gBACD;oBACE,YAAY,EAAE,0BAA0B;oBACxC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;CAwBlB;iBACQ;gBACD;oBACE,YAAY,EAAE,uCAAuC;oBACrD,OAAO,EAAE;;;;;;;;;;;;;;;;;CAiBlB;iBACQ;gBACD;oBACE,YAAY,EAAE,kCAAkC;oBAChD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB;iBACQ;gBACD;oBACE,YAAY,EAAE,iCAAiC;oBAC/C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;CAsBlB;iBACQ;gBACD;oBACE,YAAY,EAAE,oBAAoB;oBAClC,OAAO,EAAE;;;;;;;;;;;;;;;;;CAiBlB;iBACQ;gBACD;oBACE,YAAY,EAAE,sBAAsB;oBACpC,OAAO,EAAE;;;;;;;;;;;;CAYlB;iBACQ;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/scan/tarball.d.ts

@@ -0,0 +1,23 @@
+export interface TarballEntryInput {
+    /** Archive path, using forward slashes and no leading slash. */
+    path: string;
+    data: Buffer | string;
+    mtime?: Date;
+    mode?: number;
+}
+export interface CreateDirectoryTarballOptions {
+    rootDir: string;
+    outFile: string;
+    extraEntries?: TarballEntryInput[];
+    exclude?: (relativePath: string) => boolean;
+}
+/**
+ * Write a dependency-free `.tgz` archive for a Ghost package directory.
+ *
+ * This intentionally implements only the portable subset Ghost needs: ustar
+ * regular-file entries, deterministic path ordering, no symlink traversal.
+ */
+export declare function writeDirectoryTarball(options: CreateDirectoryTarballOptions): Promise<void>;
+export declare function createTarArchive(entries: TarballEntryInput[]): Buffer;
+export declare function defaultArchiveName(id: string): string;
+//# sourceMappingURL=tarball.d.ts.map

package/dist/scan/tarball.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tarball.d.ts","sourceRoot":"","sources":["../../src/scan/tarball.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAC7C;AAYD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAyBrE;AA+HD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAErD"}