@shrkcrft/inspector 0.1.0-alpha.1

package/dist/dashboard-export.d.ts

@@ -0,0 +1,67 @@
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const DASHBOARD_EXPORT_SCHEMA = "sharkcraft.dashboard-export/v1";
+export type DashboardExportSection = 'quality' | 'repository-map' | 'architecture' | 'intelligence' | 'commands' | 'safety' | 'packs' | 'sessions' | 'bundles' | 'recent-reports' | 'role-views' | 'languages';
+export interface IDashboardExportIndexEntry {
+    section: DashboardExportSection;
+    file: string;
+    bytes: number;
+}
+export interface IDashboardExportReport {
+    schema: typeof DASHBOARD_EXPORT_SCHEMA;
+    generatedAt: string;
+    outputDir: string;
+    entries: readonly IDashboardExportIndexEntry[];
+}
+export interface IDashboardExportOptions {
+    outputDir: string;
+    include?: readonly DashboardExportSection[];
+}
+export declare function buildDashboardExport(inspection: ISharkcraftInspection, options: IDashboardExportOptions): Promise<IDashboardExportReport>;
+export interface IDashboardExportDiff {
+    schema: 'sharkcraft.dashboard-export-diff/v1';
+    generatedAt: string;
+    oldDir: string;
+    newDir: string;
+    sections: readonly {
+        section: string;
+        oldBytes: number;
+        newBytes: number;
+        delta: number;
+    }[];
+    metrics: {
+        packs: {
+            old: number;
+            new: number;
+            delta: number;
+        };
+        commands: {
+            old: number;
+            new: number;
+            delta: number;
+        };
+        graphNodes: {
+            old: number;
+            new: number;
+            delta: number;
+        };
+        graphEdges: {
+            old: number;
+            new: number;
+            delta: number;
+        };
+        architectureRisks: {
+            old: number;
+            new: number;
+            delta: number;
+        };
+        boundaryViolations: {
+            old: number;
+            new: number;
+            delta: number;
+        };
+    };
+}
+export declare function diffDashboardExports(oldDir: string, newDir: string): IDashboardExportDiff;
+export declare function renderDashboardExportDiffMarkdown(diff: IDashboardExportDiff): string;
+export declare function renderDashboardExportDiffHtml(diff: IDashboardExportDiff): string;
+//# sourceMappingURL=dashboard-export.d.ts.map

package/dist/dashboard-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-export.d.ts","sourceRoot":"","sources":["../src/dashboard-export.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,UAAU,GACV,QAAQ,GACR,OAAO,GACP,UAAU,GACV,SAAS,GACT,gBAAgB,GAChB,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,sBAAsB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,uBAAuB,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC7C;AAuBD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,EACjC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAwEjC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,qCAAqC,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5F,OAAO,EAAE;QACP,KAAK,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACnD,QAAQ,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,UAAU,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACxD,UAAU,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACxD,iBAAiB,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/D,kBAAkB,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KACjE,CAAC;CACH;AAiBD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB,CA8DzF;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAapF;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAiBhF"}

package/dist/dashboard-export.js

@@ -0,0 +1,203 @@
+/**
+ * Dashboard data export.
+ *
+ * Aggregates inspector data into a flat set of JSON files that any
+ * (downstream) UI can consume. The SharkCraft dashboard ships its own
+ * React+Vite bundle; this export is the read-only data feed any other
+ * UI could use.
+ *
+ * Writes only into the user-supplied output directory. Never writes
+ * source files.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { buildArchitectureMap } from "./architecture-map.js";
+import { buildRepositoryIntelligenceGraph } from "./repository-intelligence.js";
+import { buildRepositoryMap } from "./repository-map.js";
+import { listRoleViews } from "./role-views.js";
+export const DASHBOARD_EXPORT_SCHEMA = 'sharkcraft.dashboard-export/v1';
+const DEFAULT_SECTIONS = [
+    'repository-map',
+    'architecture',
+    'intelligence',
+    'commands',
+    'safety',
+    'packs',
+    'sessions',
+    'bundles',
+    'recent-reports',
+    'role-views',
+    'languages',
+];
+function writeSection(dir, name, data) {
+    const file = nodePath.join(dir, `${name}.json`);
+    const body = JSON.stringify(data, null, 2);
+    writeFileSync(file, body, 'utf8');
+    return { section: name, file, bytes: Buffer.byteLength(body, 'utf8') };
+}
+export async function buildDashboardExport(inspection, options) {
+    const include = new Set(options.include && options.include.length > 0 ? options.include : DEFAULT_SECTIONS);
+    const dir = nodePath.isAbsolute(options.outputDir)
+        ? options.outputDir
+        : nodePath.resolve(inspection.projectRoot, options.outputDir);
+    mkdirSync(dir, { recursive: true });
+    const entries = [];
+    if (include.has('repository-map')) {
+        entries.push(writeSection(dir, 'repository-map', await buildRepositoryMap(inspection)));
+    }
+    if (include.has('architecture')) {
+        entries.push(writeSection(dir, 'architecture-map', await buildArchitectureMap(inspection)));
+    }
+    if (include.has('intelligence')) {
+        entries.push(writeSection(dir, 'intelligence-graph', await buildRepositoryIntelligenceGraph(inspection)));
+    }
+    if (include.has('role-views')) {
+        entries.push(writeSection(dir, 'role-views', listRoleViews()));
+    }
+    if (include.has('packs')) {
+        entries.push(writeSection(dir, 'packs', {
+            validPacks: inspection.packs.validPacks ?? [],
+            invalidPacks: inspection.packs.invalidPacks ?? [],
+            warnings: inspection.packs.warnings ?? [],
+        }));
+    }
+    if (include.has('commands')) {
+        entries.push(writeSection(dir, 'commands', {
+            note: 'Run `shrk commands --json` to fetch the live catalog from the CLI.',
+        }));
+    }
+    if (include.has('safety')) {
+        entries.push(writeSection(dir, 'safety', {
+            note: 'Run `shrk safety audit --json` and `shrk safety audit --deep --json` for the canonical safety surface.',
+        }));
+    }
+    if (include.has('sessions')) {
+        entries.push(writeSection(dir, 'sessions', { note: 'Sessions live under .sharkcraft/sessions/.' }));
+    }
+    if (include.has('bundles')) {
+        entries.push(writeSection(dir, 'bundles', { note: 'Bundles live under .sharkcraft/bundles/.' }));
+    }
+    if (include.has('recent-reports')) {
+        entries.push(writeSection(dir, 'recent-reports', { note: 'Reports live under .sharkcraft/reports/.' }));
+    }
+    if (include.has('languages')) {
+        // Language snapshot for the dashboard. Detect locally + run a
+        // shallow polyglot dependency scan so the UI can render a card without
+        // re-running the analysis.
+        const { detectLanguageProfiles, buildLanguageCommandReport, scanPolyglotDependencies } = await import("./languages/index.js");
+        const profiles = detectLanguageProfiles(inspection.projectRoot);
+        const commands = buildLanguageCommandReport(inspection.projectRoot, profiles);
+        const deps = scanPolyglotDependencies(inspection.projectRoot);
+        entries.push(writeSection(dir, 'languages', { profiles, commands, dependencies: deps }));
+    }
+    // index.json — manifest of what was written.
+    const index = {
+        schema: DASHBOARD_EXPORT_SCHEMA,
+        generatedAt: new Date().toISOString(),
+        outputDir: dir,
+        entries,
+    };
+    writeFileSync(nodePath.join(dir, 'index.json'), JSON.stringify(index, null, 2), 'utf8');
+    return index;
+}
+function readJsonOrNull(file) {
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function safeNumber(v, key) {
+    if (!v || typeof v !== 'object')
+        return 0;
+    const raw = v[key];
+    return typeof raw === 'number' ? raw : 0;
+}
+export function diffDashboardExports(oldDir, newDir) {
+    const oldIndex = readJsonOrNull(nodePath.join(oldDir, 'index.json')) ?? null;
+    const newIndex = readJsonOrNull(nodePath.join(newDir, 'index.json')) ?? null;
+    const oldEntries = oldIndex?.entries ?? [];
+    const newEntries = newIndex?.entries ?? [];
+    const byName = new Map();
+    for (const e of oldEntries) {
+        const existing = byName.get(e.section);
+        byName.set(e.section, { ...(existing ?? {}), old: e.bytes });
+    }
+    for (const e of newEntries) {
+        const existing = byName.get(e.section);
+        byName.set(e.section, { ...(existing ?? {}), new: e.bytes });
+    }
+    const sections = [...byName.entries()].map(([section, v]) => ({
+        section,
+        oldBytes: v.old ?? 0,
+        newBytes: v.new ?? 0,
+        delta: (v.new ?? 0) - (v.old ?? 0),
+    }));
+    const oldGraph = readJsonOrNull(nodePath.join(oldDir, 'intelligence-graph.json'));
+    const newGraph = readJsonOrNull(nodePath.join(newDir, 'intelligence-graph.json'));
+    const oldArch = readJsonOrNull(nodePath.join(oldDir, 'architecture-map.json'));
+    const newArch = readJsonOrNull(nodePath.join(newDir, 'architecture-map.json'));
+    const oldPacks = readJsonOrNull(nodePath.join(oldDir, 'packs.json'));
+    const newPacks = readJsonOrNull(nodePath.join(newDir, 'packs.json'));
+    const oldNodes = Array.isArray(oldGraph?.nodes) ? oldGraph.nodes.length : 0;
+    const newNodes = Array.isArray(newGraph?.nodes) ? newGraph.nodes.length : 0;
+    const oldEdges = Array.isArray(oldGraph?.edges) ? oldGraph.edges.length : 0;
+    const newEdges = Array.isArray(newGraph?.edges) ? newGraph.edges.length : 0;
+    const oldRisks = Array.isArray(oldArch?.risks) ? oldArch.risks.length : 0;
+    const newRisks = Array.isArray(newArch?.risks) ? newArch.risks.length : 0;
+    const oldBVE = (oldArch?.boundaryViolationCounts?.error ?? 0) + (oldArch?.boundaryViolationCounts?.warning ?? 0);
+    const newBVE = (newArch?.boundaryViolationCounts?.error ?? 0) + (newArch?.boundaryViolationCounts?.warning ?? 0);
+    const oldPacksN = Array.isArray(oldPacks?.validPacks) ? oldPacks.validPacks.length : 0;
+    const newPacksN = Array.isArray(newPacks?.validPacks) ? newPacks.validPacks.length : 0;
+    return {
+        schema: 'sharkcraft.dashboard-export-diff/v1',
+        generatedAt: new Date().toISOString(),
+        oldDir,
+        newDir,
+        sections,
+        metrics: {
+            packs: { old: oldPacksN, new: newPacksN, delta: newPacksN - oldPacksN },
+            commands: { old: safeNumber(oldGraph, 'commands'), new: safeNumber(newGraph, 'commands'), delta: 0 },
+            graphNodes: { old: oldNodes, new: newNodes, delta: newNodes - oldNodes },
+            graphEdges: { old: oldEdges, new: newEdges, delta: newEdges - oldEdges },
+            architectureRisks: { old: oldRisks, new: newRisks, delta: newRisks - oldRisks },
+            boundaryViolations: { old: oldBVE, new: newBVE, delta: newBVE - oldBVE },
+        },
+    };
+}
+export function renderDashboardExportDiffMarkdown(diff) {
+    const lines = [];
+    lines.push('# Dashboard export diff');
+    lines.push('');
+    lines.push(`- packs: ${diff.metrics.packs.old} → ${diff.metrics.packs.new} (Δ ${diff.metrics.packs.delta >= 0 ? '+' : ''}${diff.metrics.packs.delta})`);
+    lines.push(`- graph nodes: ${diff.metrics.graphNodes.old} → ${diff.metrics.graphNodes.new}`);
+    lines.push(`- graph edges: ${diff.metrics.graphEdges.old} → ${diff.metrics.graphEdges.new}`);
+    lines.push(`- architecture risks: ${diff.metrics.architectureRisks.old} → ${diff.metrics.architectureRisks.new}`);
+    lines.push(`- boundary violations: ${diff.metrics.boundaryViolations.old} → ${diff.metrics.boundaryViolations.new}`);
+    lines.push('');
+    lines.push('## Section sizes (bytes)');
+    for (const s of diff.sections)
+        lines.push(`- \`${s.section}\`: ${s.oldBytes} → ${s.newBytes} (Δ ${s.delta >= 0 ? '+' : ''}${s.delta})`);
+    return lines.join('\n') + '\n';
+}
+export function renderDashboardExportDiffHtml(diff) {
+    const esc = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    const body = [];
+    body.push('<h1>Dashboard export diff</h1>');
+    body.push('<ul>');
+    body.push(`<li>packs: ${diff.metrics.packs.old} → ${diff.metrics.packs.new} (Δ ${diff.metrics.packs.delta})</li>`);
+    body.push(`<li>graph nodes: ${diff.metrics.graphNodes.old} → ${diff.metrics.graphNodes.new}</li>`);
+    body.push(`<li>graph edges: ${diff.metrics.graphEdges.old} → ${diff.metrics.graphEdges.new}</li>`);
+    body.push(`<li>architecture risks: ${diff.metrics.architectureRisks.old} → ${diff.metrics.architectureRisks.new}</li>`);
+    body.push(`<li>boundary violations: ${diff.metrics.boundaryViolations.old} → ${diff.metrics.boundaryViolations.new}</li>`);
+    body.push('</ul>');
+    body.push('<table><thead><tr><th>Section</th><th>Old bytes</th><th>New bytes</th><th>Δ</th></tr></thead><tbody>');
+    for (const s of diff.sections) {
+        body.push(`<tr><td>${esc(s.section)}</td><td>${s.oldBytes}</td><td>${s.newBytes}</td><td>${s.delta}</td></tr>`);
+    }
+    body.push('</tbody></table>');
+    return `<!doctype html><meta charset="utf-8"><title>Dashboard export diff</title>${body.join('\n')}`;
+}

package/dist/decision-records.d.ts

@@ -0,0 +1,47 @@
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const DECISION_RECORD_SCHEMA = "sharkcraft.decision/v1";
+export declare enum DecisionStatus {
+    Proposed = "proposed",
+    Accepted = "accepted",
+    Rejected = "rejected",
+    Superseded = "superseded"
+}
+export interface IDecisionRecord {
+    schema: typeof DECISION_RECORD_SCHEMA;
+    id: string;
+    title: string;
+    status: DecisionStatus;
+    context: string;
+    decision: string;
+    consequences: string;
+    relatedRules: readonly string[];
+    relatedPolicies: readonly string[];
+    relatedConstructs: readonly string[];
+    relatedFiles: readonly string[];
+    date: string;
+    sourceFile?: string;
+}
+export interface IDecisionDraftInput {
+    id: string;
+    title: string;
+    status?: DecisionStatus;
+    context?: string;
+    decision?: string;
+    consequences?: string;
+    relatedRules?: readonly string[];
+    relatedPolicies?: readonly string[];
+    relatedConstructs?: readonly string[];
+    relatedFiles?: readonly string[];
+    date?: string;
+}
+export declare function listDecisions(inspection: ISharkcraftInspection): readonly IDecisionRecord[];
+/**
+ * Async warm-up for `sharkcraft/decisions.ts` and pack-contributed
+ * decisions. Call this before `listDecisions` if you want TS decisions
+ * folded in.
+ */
+export declare function loadTsDecisions(inspection: ISharkcraftInspection): Promise<readonly IDecisionRecord[]>;
+export declare function getDecision(inspection: ISharkcraftInspection, id: string): IDecisionRecord | undefined;
+export declare function previewDecisionDraft(input: IDecisionDraftInput): string;
+export declare function decisionDraftTargetPath(projectRoot: string, id: string): string;
+//# sourceMappingURL=decision-records.d.ts.map

package/dist/decision-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-records.d.ts","sourceRoot":"","sources":["../src/decision-records.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,sBAAsB,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA8CD,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,eAAe,EAAE,CAyD3F;AA0BD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAuCrC;AAaD,wBAAgB,WAAW,CAAC,UAAU,EAAE,qBAAqB,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEtG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CA0CvE;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/E"}

package/dist/decision-records.js

@@ -0,0 +1,255 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+/**
+ * Decision / ADR support.
+ *
+ * Decisions are markdown records with YAML-ish frontmatter living under
+ * `sharkcraft/decisions/` or `docs/adr/`. SharkCraft does NOT auto-write
+ * these — `decisions new` produces a dry-run preview unless
+ * `--write-draft` is passed.
+ *
+ * Read-only operations: list, get, link (preview).
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import * as nodePath from 'node:path';
+export const DECISION_RECORD_SCHEMA = 'sharkcraft.decision/v1';
+export var DecisionStatus;
+(function (DecisionStatus) {
+    DecisionStatus["Proposed"] = "proposed";
+    DecisionStatus["Accepted"] = "accepted";
+    DecisionStatus["Rejected"] = "rejected";
+    DecisionStatus["Superseded"] = "superseded";
+})(DecisionStatus || (DecisionStatus = {}));
+const DECISION_DIRS = ['sharkcraft/decisions', 'docs/adr'];
+function frontmatterAndBody(text) {
+    const m = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/.exec(text);
+    if (!m)
+        return { fm: {}, body: text };
+    const fm = {};
+    for (const line of (m[1] ?? '').split('\n')) {
+        const idx = line.indexOf(':');
+        if (idx <= 0)
+            continue;
+        const k = line.slice(0, idx).trim();
+        const v = line.slice(idx + 1).trim().replace(/^"(.*)"$/, '$1');
+        fm[k] = v;
+    }
+    return { fm, body: m[2] ?? '' };
+}
+function sectionFromBody(body, header) {
+    const lines = body.split('\n');
+    const out = [];
+    let inSection = false;
+    for (const line of lines) {
+        const isHeading = /^#{1,3}\s+/.test(line);
+        if (isHeading) {
+            if (inSection)
+                break;
+            if (new RegExp(`^#{1,3}\\s+${header}\\b`, 'i').test(line)) {
+                inSection = true;
+                continue;
+            }
+        }
+        else if (inSection) {
+            out.push(line);
+        }
+    }
+    return out.join('\n').trim();
+}
+function listLinesUnder(body, header) {
+    const section = sectionFromBody(body, header);
+    if (!section)
+        return [];
+    return section
+        .split('\n')
+        .map((l) => l.replace(/^[-*]\s+/, '').trim())
+        .filter(Boolean);
+}
+export function listDecisions(inspection) {
+    const out = [];
+    const seenIds = new Set();
+    const addMd = (rec) => {
+        if (seenIds.has(rec.id))
+            return;
+        seenIds.add(rec.id);
+        out.push(rec);
+    };
+    for (const rel of DECISION_DIRS) {
+        const dir = nodePath.join(inspection.projectRoot, rel);
+        if (!existsSync(dir))
+            continue;
+        let entries = [];
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const f of entries) {
+            if (!/\.(md|markdown)$/i.test(f))
+                continue;
+            const full = nodePath.join(dir, f);
+            try {
+                const st = statSync(full);
+                if (!st.isFile())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            const text = readFileSync(full, 'utf8');
+            const { fm, body } = frontmatterAndBody(text);
+            const id = (fm['id'] ?? nodePath.basename(f, nodePath.extname(f))).trim();
+            const title = fm['title'] ?? id;
+            const status = fm['status'] ?? DecisionStatus.Proposed;
+            const date = fm['date'] ?? '';
+            addMd({
+                schema: DECISION_RECORD_SCHEMA,
+                id,
+                title,
+                status,
+                context: sectionFromBody(body, 'Context'),
+                decision: sectionFromBody(body, 'Decision'),
+                consequences: sectionFromBody(body, 'Consequences'),
+                relatedRules: listLinesUnder(body, 'Related rules'),
+                relatedPolicies: listLinesUnder(body, 'Related policies'),
+                relatedConstructs: listLinesUnder(body, 'Related constructs'),
+                relatedFiles: listLinesUnder(body, 'Related files'),
+                date,
+                sourceFile: full,
+            });
+        }
+    }
+    // Also include sync-cached TS decisions if present (loaded by
+    // listDecisionsTsCached on prior async warm-up). Best-effort sync read.
+    for (const r of getTsDecisionsCached(inspection.projectRoot)) {
+        if (seenIds.has(r.id))
+            continue;
+        seenIds.add(r.id);
+        out.push(r);
+    }
+    return out;
+}
+const TS_DECISION_CACHE = new Map();
+function getTsDecisionsCached(projectRoot) {
+    return TS_DECISION_CACHE.get(projectRoot) ?? [];
+}
+/**
+ * Async warm-up for `sharkcraft/decisions.ts` and pack-contributed
+ * decisions. Call this before `listDecisions` if you want TS decisions
+ * folded in.
+ */
+export async function loadTsDecisions(inspection) {
+    const out = [];
+    const seen = new Set();
+    const addInput = (rec, source) => {
+        if (!rec?.id || seen.has(rec.id))
+            return;
+        seen.add(rec.id);
+        out.push({
+            schema: DECISION_RECORD_SCHEMA,
+            id: rec.id,
+            title: rec.title ?? rec.id,
+            status: (rec.status ?? DecisionStatus.Proposed),
+            context: rec.context ?? '',
+            decision: rec.decision ?? '',
+            consequences: rec.consequences ?? '',
+            relatedRules: rec.relatedRules ?? [],
+            relatedPolicies: rec.relatedPolicies ?? [],
+            relatedConstructs: rec.relatedConstructs ?? [],
+            relatedFiles: rec.relatedFiles ?? [],
+            date: rec.date ?? '',
+            sourceFile: source,
+        });
+    };
+    // Local file.
+    if (inspection.sharkcraftDir) {
+        const local = nodePath.join(inspection.sharkcraftDir, 'decisions.ts');
+        const arr = await importDefaultArray(local);
+        for (const r of arr)
+            addInput(r, local);
+    }
+    // Pack contributions.
+    for (const pack of inspection.packs.validPacks) {
+        const c = (pack.manifest?.contributions ?? {});
+        for (const rel of c.decisionFiles ?? []) {
+            const full = nodePath.resolve(pack.packageRoot, rel);
+            const arr = await importDefaultArray(full);
+            for (const r of arr)
+                addInput(r, full);
+        }
+    }
+    TS_DECISION_CACHE.set(inspection.projectRoot, out);
+    return out;
+}
+async function importDefaultArray(absPath) {
+    try {
+        if (!existsSync(absPath))
+            return [];
+        const { pathToFileURL } = await import('node:url');
+        const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(absPath).href)));
+        return Array.isArray(mod.default) ? mod.default : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function getDecision(inspection, id) {
+    return listDecisions(inspection).find((d) => d.id === id);
+}
+export function previewDecisionDraft(input) {
+    const id = input.id.trim();
+    const lines = [];
+    lines.push('---');
+    lines.push(`id: ${id}`);
+    lines.push(`title: ${input.title}`);
+    lines.push(`status: ${input.status ?? DecisionStatus.Proposed}`);
+    lines.push(`date: ${input.date ?? new Date().toISOString().slice(0, 10)}`);
+    lines.push('---');
+    lines.push('');
+    lines.push(`# ${input.title}`);
+    lines.push('');
+    lines.push('## Context');
+    lines.push(input.context ?? '_TBD — describe the forces, constraints, and why a decision is needed._');
+    lines.push('');
+    lines.push('## Decision');
+    lines.push(input.decision ?? '_TBD — describe the chosen direction._');
+    lines.push('');
+    lines.push('## Consequences');
+    lines.push(input.consequences ?? '_TBD — describe positive + negative implications._');
+    lines.push('');
+    if (input.relatedRules?.length) {
+        lines.push('## Related rules');
+        for (const r of input.relatedRules)
+            lines.push(`- ${r}`);
+        lines.push('');
+    }
+    if (input.relatedPolicies?.length) {
+        lines.push('## Related policies');
+        for (const p of input.relatedPolicies)
+            lines.push(`- ${p}`);
+        lines.push('');
+    }
+    if (input.relatedConstructs?.length) {
+        lines.push('## Related constructs');
+        for (const c of input.relatedConstructs)
+            lines.push(`- ${c}`);
+        lines.push('');
+    }
+    if (input.relatedFiles?.length) {
+        lines.push('## Related files');
+        for (const f of input.relatedFiles)
+            lines.push(`- ${f}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function decisionDraftTargetPath(projectRoot, id) {
+    return nodePath.join(projectRoot, 'sharkcraft/decisions', `${id}.md`);
+}

package/dist/demo-package.d.ts

@@ -0,0 +1,49 @@
+import { DemoScenario } from './demo-script.js';
+export declare const DEMO_PACKAGE_SCHEMA = "sharkcraft.demo-package/v1";
+export type DemoPackageScope = 'all' | DemoScenario;
+export interface IDemoPackageFile {
+    /** Absolute path on disk. */
+    path: string;
+    bytes: number;
+    /** Short description (shown in README index). */
+    description: string;
+}
+export interface IDemoPackageResult {
+    schema: typeof DEMO_PACKAGE_SCHEMA;
+    outputDir: string;
+    scenarios: readonly DemoScenario[];
+    files: readonly IDemoPackageFile[];
+}
+export interface IBuildDemoPackageInput {
+    outputDir: string;
+    /** `all` includes every scenario; otherwise just one scenario. */
+    scope: DemoPackageScope;
+}
+export declare const DEMO_PACKAGE_VALIDATE_SCHEMA = "sharkcraft.demo-package-validate/v1";
+export interface IDemoPackageValidateFinding {
+    code: 'destructive-command' | 'unknown-shrk-command' | 'script-not-executable' | 'expected-commands-missing' | 'demo-sh-missing';
+    severity: 'info' | 'warning' | 'error';
+    message: string;
+    file?: string;
+    line?: number;
+}
+export interface IDemoPackageValidateReport {
+    schema: typeof DEMO_PACKAGE_VALIDATE_SCHEMA;
+    generatedAt: string;
+    outputDir: string;
+    scenariosChecked: readonly DemoScenario[];
+    commandsFound: readonly string[];
+    findings: readonly IDemoPackageValidateFinding[];
+    ok: boolean;
+}
+export interface IValidateDemoPackageInput {
+    scope: DemoPackageScope;
+    /** Optional list of known catalog commands; unknown commands become findings. */
+    knownCommands?: readonly string[];
+    /** Pre-existing directory to inspect. If absent, the package is built into a temp dir. */
+    outputDir?: string;
+}
+export declare function validateDemoPackage(input: IValidateDemoPackageInput): IDemoPackageValidateReport;
+export declare function renderDemoPackageValidateText(report: IDemoPackageValidateReport): string;
+export declare function buildDemoPackage(input: IBuildDemoPackageInput): IDemoPackageResult;
+//# sourceMappingURL=demo-package.d.ts.map

package/dist/demo-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-package.d.ts","sourceRoot":"","sources":["../src/demo-package.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EAKb,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,YAAY,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,mBAAmB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAmID,eAAO,MAAM,4BAA4B,wCAAwC,CAAC;AAElF,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EACA,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,GACvB,2BAA2B,GAC3B,iBAAiB,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,OAAO,4BAA4B,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACjD,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,gBAAgB,CAAC;IACxB,iFAAiF;IACjF,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,yBAAyB,GAAG,0BAA0B,CA2GhG;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CAexF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,GAAG,kBAAkB,CA8BlF"}