@devenius/junamis-skills 0.0.0-stage → 1.1.0

package/dist/design/drift.js

@@ -0,0 +1,341 @@
+// Design drift detectors.
+//
+// Code drift compares files matched by code_paths against the surface's
+// last_reviewed_commit, or against last_reviewed by mtime when git is
+// unavailable. Dependency drift compares the dependent surface's current
+// version with the version recorded in its change log at or before this
+// surface's last_reviewed. Coverage reports overlapping claims and unclaimed
+// source files; overlap is always reported, and the bootstrap flag gates the
+// failure until a human or architect flips it.
+import { spawnSync } from "node:child_process";
+import { join, relative } from "node:path";
+import { listDir, readJsonFile, statSafe, toPosixPath } from "../orchestrator/fsx.js";
+import { ValidationError } from "./errors.js";
+import { loadSurfaces } from "./schema.js";
+import { isRecord } from "../types/guards.js";
+const EXCLUDED_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".orchestrator",
+    ".junamis",
+    ".config",
+    "docs",
+    "test",
+    "tests",
+    "coverage",
+    "dist",
+    "build",
+    "out",
+]);
+const CODE_EXTENSIONS = new Set([
+    ".js",
+    ".mjs",
+    ".cjs",
+    ".jsx",
+    ".ts",
+    ".tsx",
+    ".vue",
+    ".svelte",
+    ".py",
+    ".go",
+    ".rs",
+    ".java",
+    ".kt",
+    ".rb",
+    ".php",
+    ".cs",
+    ".swift",
+    ".css",
+    ".scss",
+    ".sass",
+    ".less",
+    ".html",
+    ".sh",
+    ".bash",
+]);
+function escapeRegExp(char) {
+    return /[.*+?^${}()|[\]\\]/.test(char) ? `\\${char}` : char;
+}
+export function globToRegExp(pattern) {
+    const normalized = String(pattern).replace(/\\/g, "/").replace(/^\.\//, "");
+    const source = normalized.endsWith("/") ? `${normalized}**` : normalized;
+    let out = "^";
+    for (let i = 0; i < source.length; i++) {
+        const char = source[i] ?? "";
+        if (char === "*") {
+            if (source[i + 1] === "*") {
+                i += 1;
+                if (source[i + 1] === "/") {
+                    i += 1;
+                    out += "(?:.*/)?";
+                }
+                else {
+                    out += ".*";
+                }
+            }
+            else {
+                out += "[^/]*";
+            }
+            continue;
+        }
+        if (char === "?") {
+            out += "[^/]";
+            continue;
+        }
+        if (char === "[") {
+            const end = source.indexOf("]", i + 1);
+            if (end !== -1) {
+                out += source.slice(i, end + 1);
+                i = end;
+                continue;
+            }
+        }
+        out += escapeRegExp(char);
+    }
+    out += "$";
+    return new RegExp(out);
+}
+export function matchesAny(path, patterns) {
+    return (patterns ?? []).some((pattern) => {
+        try {
+            return globToRegExp(pattern).test(path);
+        }
+        catch {
+            return false;
+        }
+    });
+}
+async function walk(root, current, out) {
+    const entries = await listDir(current);
+    for (const entry of entries) {
+        if (entry.isSymbolicLink())
+            continue;
+        const path = join(current, entry.name);
+        if (entry.isDirectory()) {
+            if (EXCLUDED_DIRS.has(entry.name))
+                continue;
+            if (entry.name.startsWith("."))
+                continue;
+            await walk(root, path, out);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        out.push(toPosixPath(relative(root, path)));
+    }
+}
+export async function listProjectFiles(projectRoot) {
+    const out = [];
+    await walk(projectRoot, projectRoot, out);
+    out.sort((a, b) => Buffer.compare(Buffer.from(a, "utf8"), Buffer.from(b, "utf8")));
+    return out;
+}
+function gitLines(projectRoot, args) {
+    const result = spawnSync("git", args, {
+        cwd: projectRoot,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+    });
+    if (result.status !== 0)
+        return null;
+    return (result.stdout ?? "")
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+}
+function gitCommitTime(projectRoot, path) {
+    const lines = gitLines(projectRoot, ["log", "-1", "--format=%ct", "--", path]);
+    if (!lines || lines.length === 0)
+        return null;
+    const value = Number.parseInt(lines[0] ?? "", 10);
+    return Number.isFinite(value) ? value : null;
+}
+async function mtimeMs(path) {
+    const stat = await statSafe(path);
+    return stat ? stat.mtimeMs : null;
+}
+async function codeChangedFiles(surface, { projectRoot, matched, git }) {
+    const frontmatter = surface.frontmatter;
+    if (!frontmatter)
+        return [];
+    const commit = frontmatter.last_reviewed_commit;
+    if (git && commit) {
+        const changed = gitLines(projectRoot, ["diff", "--name-only", `${commit}..HEAD`, "--", ...matched]);
+        if (changed !== null) {
+            const matchedSet = new Set(matched);
+            const files = changed.filter((path) => matchedSet.has(path));
+            if (files.length === 0)
+                return [];
+            const designRelative = toPosixPath(relative(projectRoot, surface.file));
+            const designTime = gitCommitTime(projectRoot, designRelative);
+            let codeTime = 0;
+            for (const path of files) {
+                const time = gitCommitTime(projectRoot, path);
+                if (time !== null && time > codeTime)
+                    codeTime = time;
+            }
+            // A design update at or after the code change is the delta that
+            // accompanied it. Only code newer than the design is drift.
+            if (designTime !== null && codeTime > 0 && designTime >= codeTime)
+                return [];
+            return files;
+        }
+    }
+    const cutoff = new Date(`${frontmatter.last_reviewed ?? ""}T23:59:59Z`).getTime();
+    const changed = [];
+    for (const path of matched) {
+        const mtime = await mtimeMs(join(projectRoot, path));
+        if (mtime !== null && mtime > cutoff)
+            changed.push(path);
+    }
+    if (changed.length === 0)
+        return [];
+    const designMtime = await mtimeMs(surface.file);
+    let newest = 0;
+    for (const path of changed) {
+        const mtime = await mtimeMs(join(projectRoot, path));
+        if (mtime !== null && mtime > newest)
+            newest = mtime;
+    }
+    if (designMtime !== null && designMtime >= newest && newest > 0)
+        return [];
+    return changed;
+}
+export async function detectCodeDrift({ designRoot, projectRoot, git = true }) {
+    const loaded = await loadSurfaces(designRoot, { validate: true });
+    if (loaded.errors.length > 0) {
+        const lines = loaded.errors.flatMap((entry) => entry.errors.map((error) => `${entry.file}: ${error}`));
+        throw new ValidationError("cannot detect drift on an invalid design registry", { errors: lines });
+    }
+    const projectFiles = await listProjectFiles(projectRoot);
+    const flags = [];
+    for (const surface of loaded.surfaces) {
+        if (surface.frontmatter?.status !== "active")
+            continue;
+        const patterns = surface.frontmatter?.code_paths ?? [];
+        const matched = projectFiles.filter((path) => matchesAny(path, patterns));
+        if (matched.length === 0)
+            continue;
+        const files = await codeChangedFiles(surface, { projectRoot, matched, git });
+        if (files.length === 0)
+            continue;
+        flags.push({
+            type: "CODE_DRIFT",
+            surface_id: surface.surface_id,
+            files,
+            last_reviewed: surface.frontmatter?.last_reviewed ?? "",
+            last_reviewed_commit: surface.frontmatter?.last_reviewed_commit ?? null,
+        });
+    }
+    return flags;
+}
+function parseChangeLog(body) {
+    const entries = [];
+    for (const line of String(body ?? "").split("\n")) {
+        const match = /^-\s+(\d{4}-\d{2}-\d{2})\s+·\s+v(\d+\.\d+\.\d+)/.exec(line.trim());
+        if (match)
+            entries.push({ date: match[1] ?? "", version: match[2] ?? "" });
+    }
+    return entries;
+}
+function versionAt(entries, date) {
+    let found = null;
+    for (const entry of entries) {
+        if (entry.date <= (date ?? ""))
+            found = entry.version;
+    }
+    return found;
+}
+export async function detectDependencyDrift({ designRoot }) {
+    const loaded = await loadSurfaces(designRoot, { validate: true });
+    if (loaded.errors.length > 0) {
+        const lines = loaded.errors.flatMap((entry) => entry.errors.map((error) => `${entry.file}: ${error}`));
+        throw new ValidationError("cannot detect dependency drift on an invalid design registry", { errors: lines });
+    }
+    const byId = new Map(loaded.surfaces.map((surface) => [surface.surface_id, surface]));
+    const flags = [];
+    for (const surface of loaded.surfaces) {
+        const lastReviewed = surface.frontmatter?.last_reviewed;
+        for (const depId of surface.frontmatter?.depends_on ?? []) {
+            const dep = byId.get(depId);
+            if (!dep)
+                continue;
+            const recorded = versionAt(parseChangeLog(dep.body), lastReviewed);
+            if (recorded === null)
+                continue;
+            const current = dep.frontmatter?.version ?? null;
+            if (recorded !== current) {
+                flags.push({
+                    type: "DEPENDENCY_DRIFT",
+                    surface_id: surface.surface_id,
+                    depends_on: depId,
+                    recorded_version: recorded,
+                    current_version: current,
+                    at: lastReviewed ?? "",
+                });
+            }
+        }
+    }
+    return flags;
+}
+export async function readBootstrapFlag(designRoot) {
+    const parsed = await readJsonFile(join(designRoot, "_registry.json"));
+    if (!parsed.exists || parsed.error || !isRecord(parsed.value)) {
+        return false;
+    }
+    return parsed.value["bootstrap_complete"] === true;
+}
+export async function detectCoverage({ designRoot, projectRoot }) {
+    const loaded = await loadSurfaces(designRoot, { validate: true });
+    if (loaded.errors.length > 0) {
+        const lines = loaded.errors.flatMap((entry) => entry.errors.map((error) => `${entry.file}: ${error}`));
+        throw new ValidationError("cannot audit coverage on an invalid design registry", { errors: lines });
+    }
+    const projectFiles = await listProjectFiles(projectRoot);
+    const codeFiles = projectFiles.filter((path) => CODE_EXTENSIONS.has(extnameLower(path)));
+    const claims = new Map();
+    for (const surface of loaded.surfaces) {
+        for (const path of codeFiles) {
+            if (!matchesAny(path, surface.frontmatter?.code_paths ?? []))
+                continue;
+            const existing = claims.get(path);
+            if (existing)
+                existing.push(surface.surface_id);
+            else
+                claims.set(path, [surface.surface_id]);
+        }
+    }
+    const overlaps = [];
+    for (const [path, surfaces] of claims) {
+        if (surfaces.length > 1)
+            overlaps.push({ path, surfaces: [...surfaces].sort() });
+    }
+    const unclaimed = codeFiles.filter((path) => !claims.has(path));
+    const bootstrapComplete = await readBootstrapFlag(designRoot);
+    const enforced = bootstrapComplete === true;
+    return {
+        bootstrap_complete: bootstrapComplete,
+        enforced,
+        overlaps: overlaps.sort((a, b) => a.path.localeCompare(b.path)),
+        unclaimed,
+        claimed_files: claims.size,
+        code_files: codeFiles.length,
+    };
+}
+function extnameLower(path) {
+    const index = path.lastIndexOf(".");
+    return index === -1 ? "" : path.slice(index).toLowerCase();
+}
+export async function runDrift({ designRoot, projectRoot, git = true }) {
+    const code = await detectCodeDrift({ designRoot, projectRoot, git });
+    const dependency = await detectDependencyDrift({ designRoot });
+    const coverage = await detectCoverage({ designRoot, projectRoot });
+    const coverageFailing = coverage.enforced && (coverage.overlaps.length > 0 || coverage.unclaimed.length > 0);
+    return {
+        ok: code.length === 0 && dependency.length === 0 && !coverageFailing,
+        code,
+        dependency,
+        coverage,
+    };
+}
+//# sourceMappingURL=drift.js.map

package/dist/design/drift.js.map

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

package/dist/design/errors.d.ts

@@ -0,0 +1,25 @@
+export interface DesignErrorOptions {
+    readonly code?: string;
+    readonly exitCode?: number;
+    readonly detail?: unknown;
+}
+export declare class DesignError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    readonly detail: unknown;
+    constructor(message: string, { code, exitCode, detail }?: DesignErrorOptions);
+}
+export declare class UsageError extends DesignError {
+    constructor(message: string, options?: DesignErrorOptions);
+}
+export declare class ValidationError extends DesignError {
+    readonly errors: readonly string[];
+    constructor(message: string, { errors, detail }?: {
+        readonly errors?: readonly string[];
+        readonly detail?: unknown;
+    });
+}
+export declare class DeltaError extends DesignError {
+    constructor(message: string, { code, detail }?: DesignErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/design/errors.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAiB,IAAI,EAAE,MAAM,CAAC;IAC9B,SAAiB,QAAQ,EAAE,MAAM,CAAC;IAClC,SAAiB,MAAM,EAAE,OAAO,CAAC;IAEjC,YACE,OAAO,EAAE,MAAM,EACf,EAAE,IAAqB,EAAE,QAAY,EAAE,MAAa,EAAE,GAAE,kBAAuB,EAOhF;CACF;AAED,qBAAa,UAAW,SAAQ,WAAW;IACzC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,EAE5D;CACF;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,SAAiB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAE3C,YAAY,OAAO,EAAE,MAAM,EAAE,EAAE,MAAW,EAAE,MAAa,EAAE,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,EAGnI;CACF;AAED,qBAAa,UAAW,SAAQ,WAAW;IACzC,YAAY,OAAO,EAAE,MAAM,EAAE,EAAE,IAAsB,EAAE,MAAa,EAAE,GAAE,kBAAuB,EAE9F;CACF"}

package/dist/design/errors.js

@@ -0,0 +1,30 @@
+// Typed errors for the design registry.
+//
+// The CLI maps one error class to one exit code. Validation errors carry every
+// problem found so a single run can report the whole file.
+export class DesignError extends Error {
+    constructor(message, { code = "design_error", exitCode = 1, detail = null } = {}) {
+        super(message);
+        this.name = new.target.name;
+        this.code = code;
+        this.exitCode = exitCode;
+        this.detail = detail;
+    }
+}
+export class UsageError extends DesignError {
+    constructor(message, options = {}) {
+        super(message, { code: "usage", ...options });
+    }
+}
+export class ValidationError extends DesignError {
+    constructor(message, { errors = [], detail = null } = {}) {
+        super(message, { code: "invalid_design", detail: detail ?? { errors } });
+        this.errors = errors;
+    }
+}
+export class DeltaError extends DesignError {
+    constructor(message, { code = "invalid_delta", detail = null } = {}) {
+        super(message, { code, detail });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/design/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/design/errors.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,+EAA+E;AAC/E,2DAA2D;AAQ3D,MAAM,OAAO,WAAY,SAAQ,KAAK;IAKpC,YACE,OAAe,EACf,EAAE,IAAI,GAAG,cAAc,EAAE,QAAQ,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,GAAuB,EAAE;QAE/E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC,YAAY,OAAe,EAAE,OAAO,GAAuB,EAAE;QAC3D,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAG9C,YAAY,OAAe,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,GAAuE,EAAE;QAClI,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC,YAAY,OAAe,EAAE,EAAE,IAAI,GAAG,eAAe,EAAE,MAAM,GAAG,IAAI,EAAE,GAAuB,EAAE;QAC7F,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/design/events.d.ts

@@ -0,0 +1,18 @@
+import type { JournalEvent } from "../types/orchestrator.js";
+export interface DesignEventInput {
+    readonly stateRoot: string;
+    readonly type: string;
+    readonly payload?: Record<string, unknown>;
+    readonly taskId?: string | null;
+}
+export type DesignEventResult = {
+    readonly appended: false;
+    readonly reason: string;
+    readonly path: string;
+} | {
+    readonly appended: true;
+    readonly event: JournalEvent;
+    readonly path: string;
+};
+export declare function appendDesignEvent({ stateRoot, type, payload, taskId, }: DesignEventInput): Promise<DesignEventResult>;
+//# sourceMappingURL=events.d.ts.map

package/dist/design/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/design/events.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,wBAAsB,iBAAiB,CAAC,EACtC,SAAS,EACT,IAAI,EACJ,OAAY,EACZ,MAAa,GACd,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmC/C"}

package/dist/design/events.js

@@ -0,0 +1,44 @@
+// Design registry events on the orchestrator journal.
+//
+// The journal is the source of truth and is hash-chained. The registry appends
+// its events through the same JournalWriter so a later boot replay sees them.
+// A design event does not rewrite state.json; the next load replays the journal.
+import { join } from "node:path";
+import { JournalWriter, readJournal } from "../orchestrator/journal.js";
+const DESIGN_SESSION = "s-design-registry";
+export async function appendDesignEvent({ stateRoot, type, payload = {}, taskId = null, }) {
+    const journalPath = join(stateRoot, "journal.ndjson");
+    const info = await readJournal(journalPath);
+    if (!info.exists) {
+        return { appended: false, reason: "no_journal", path: journalPath };
+    }
+    if (info.errors.length > 0) {
+        return { appended: false, reason: "journal_unreadable", path: journalPath };
+    }
+    const last = info.events.at(-1) ?? null;
+    const writer = new JournalWriter({
+        path: journalPath,
+        events: info.events,
+        prevHash: last?.hash ?? null,
+        lastSeq: last?.seq ?? 0,
+    });
+    const event = await writer.append({
+        type,
+        run_id: last?.run_id ?? null,
+        session_id: DESIGN_SESSION,
+        ...payload,
+    });
+    if (taskId && type === "design_delta_rejected") {
+        const reason = payload["reason"];
+        await writer.append({
+            type: "escalation",
+            run_id: last?.run_id ?? null,
+            session_id: DESIGN_SESSION,
+            task_id: taskId,
+            reason: "design_delta_rejected",
+            message: typeof reason === "string" ? reason : "design delta rejected",
+        });
+    }
+    return { appended: true, event, path: journalPath };
+}
+//# sourceMappingURL=events.js.map

package/dist/design/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/design/events.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,iFAAiF;AAEjF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGxE,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAa3C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EACtC,SAAS,EACT,IAAI,EACJ,OAAO,GAAG,EAAE,EACZ,MAAM,GAAG,IAAI,GACI;IACjB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;QAC/B,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;QAC5B,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;KACxB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;QAChC,IAAI;QACJ,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI;QAC5B,UAAU,EAAE,cAAc;QAC1B,GAAG,OAAO;KACX,CAAC,CAAC;IAEH,IAAI,MAAM,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI;YAC5B,UAAU,EAAE,cAAc;YAC1B,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,uBAAuB;YAC/B,OAAO,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB;SACvE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACtD,CAAC"}

package/dist/design/fingerprint.d.ts

@@ -0,0 +1,10 @@
+import type { DesignFingerprint } from "../types/design.js";
+export interface DesignFingerprintResult {
+    readonly registry: DesignFingerprint | null;
+    readonly files: Record<string, string> | null;
+    readonly designRoot: string | null;
+}
+export declare function computeDesignFingerprint({ designRoot, }?: {
+    readonly designRoot?: string | null;
+}): Promise<DesignFingerprintResult>;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/design/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/design/fingerprint.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,oBAAoB,CAAC;AAY1E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,wBAAsB,wBAAwB,CAAC,EAC7C,UAAiB,GAClB,GAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA2CjF"}

package/dist/design/fingerprint.js

@@ -0,0 +1,66 @@
+// Design registry fingerprint for RESUME.md B4.
+//
+// index_sha256 binds the actual INDEX.md bytes and every surface file, so a
+// body edit is drift even when the derived table would not change. The field
+// name stays index_sha256 per the contract; the hash covers the indexed set.
+import { createHash } from "node:crypto";
+import { join, relative } from "node:path";
+import { readBuffer, statSafe, toPosixPath } from "../orchestrator/fsx.js";
+import { sha256Hex } from "../orchestrator/hash.js";
+import { listSurfaceFiles, STATUS_ORDER } from "./schema.js";
+import { parseFrontmatterDocument } from "./yaml.js";
+function emptyStatusCounts() {
+    const counts = { active: 0, draft: 0, deprecated: 0, needs_review: 0 };
+    for (const status of STATUS_ORDER)
+        counts[status] = 0;
+    return counts;
+}
+function isDesignStatus(value) {
+    return typeof value === "string" && STATUS_ORDER.includes(value);
+}
+export async function computeDesignFingerprint({ designRoot = null, } = {}) {
+    if (!designRoot)
+        return { registry: null, files: null, designRoot: null };
+    const stat = await statSafe(designRoot);
+    if (!stat || !stat.isDirectory())
+        return { registry: null, files: null, designRoot };
+    const files = await listSurfaceFiles(designRoot);
+    const fileMap = {};
+    const statusCounts = emptyStatusCounts();
+    const hash = createHash("sha256");
+    const indexBytes = await readBuffer(join(designRoot, "INDEX.md"));
+    hash.update("index\0");
+    hash.update(indexBytes ?? Buffer.from("missing", "utf8"));
+    hash.update("\0");
+    for (const file of files) {
+        const relativePath = toPosixPath(relative(designRoot, file));
+        const bytes = await readBuffer(file);
+        if (bytes === null)
+            continue;
+        fileMap[relativePath] = `sha256:${sha256Hex(bytes)}`;
+        hash.update(relativePath);
+        hash.update("\0");
+        hash.update(bytes);
+        hash.update("\0");
+        try {
+            const parsed = parseFrontmatterDocument(bytes.toString("utf8"), { label: relativePath });
+            const status = parsed.data["status"];
+            if (isDesignStatus(status))
+                statusCounts[status] += 1;
+        }
+        catch {
+            // An unparsable surface still changes the file hash. Boot reports the
+            // drift; it does not guess the status.
+        }
+    }
+    return {
+        registry: {
+            index_sha256: `sha256:${hash.digest("hex")}`,
+            surface_count: files.length,
+            status_counts: statusCounts,
+        },
+        files: fileMap,
+        designRoot,
+    };
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/design/fingerprint.js.map

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

package/dist/design/index-gen.d.ts

@@ -0,0 +1,16 @@
+import type { DesignSurface, IndexResult } from "../types/design.js";
+declare function byteSort(values: readonly string[]): string[];
+export declare function countGaps(body: unknown): number;
+export declare function deriveGeneratedAt(surfaces: readonly DesignSurface[], override?: string | null): string;
+export interface GenerateIndexInput {
+    readonly designRoot: string;
+    readonly generatedAt?: string | null;
+}
+export declare function generateIndex({ designRoot, generatedAt }: GenerateIndexInput): Promise<IndexResult>;
+export declare function indexFilePath(designRoot: string): string;
+export interface WrittenIndex extends IndexResult {
+    readonly path: string;
+}
+export declare function writeIndex({ designRoot, generatedAt }: GenerateIndexInput): Promise<WrittenIndex>;
+export { byteSort };
+//# sourceMappingURL=index-gen.d.ts.map

package/dist/design/index-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-gen.d.ts","sourceRoot":"","sources":["../../src/design/index-gen.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIrE,iBAAS,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAErD;AAOD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAW/C;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,CAe5G;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,wBAAsB,aAAa,CAAC,EAAE,UAAU,EAAE,WAAkB,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAoChH;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,UAAU,CAAC,EAAE,UAAU,EAAE,WAAkB,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAK9G;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}