@deftai/directive-core 0.55.0

package/dist/packs/index.js

@@ -0,0 +1,4 @@
+export * as packRender from "./pack-render.js";
+export * as packsSlice from "./packs-slice.js";
+export * as quarantineExt from "./quarantine-ext.js";
+//# sourceMappingURL=index.js.map

package/dist/packs/pack-render.d.ts

@@ -0,0 +1,31 @@
+/** Port of scripts/pack_render.py — content-pack projection renderer (#1294, #1295). */
+export declare function resolveRepoRoot(): string;
+export declare const DEFAULT_SOURCE: string;
+export declare const DEFAULT_OUTPUT: string;
+export declare const BANNER: string;
+export declare const DOC_TITLE = "# Lessons Learned";
+export interface RenderRegistryEntry {
+    readonly mode: "collection" | "documents";
+    readonly source: string;
+    readonly output?: string;
+    readonly items_field: string;
+    readonly heading_field?: string;
+    readonly body_field: string;
+    readonly title?: string;
+    readonly banner: readonly string[];
+    readonly doc_kind?: "skill" | "markdown";
+    readonly name_field?: string;
+    readonly description_field?: string;
+    readonly path_field?: string;
+}
+export declare const RENDER_REGISTRY: Record<string, RenderRegistryEntry>;
+export declare function renderCollection(pack: Record<string, unknown>, cfg: RenderRegistryEntry): string;
+export declare function renderSkillDocument(entry: Record<string, unknown>, cfg: RenderRegistryEntry): string;
+export declare function renderMarkdownDocument(entry: Record<string, unknown>, cfg: RenderRegistryEntry): string;
+export declare function collectTargets(packFilter?: string | null): Array<[string, string, string]>;
+export declare function render(pack: Record<string, unknown>): string;
+export declare function renderFile(source: string): string;
+export declare function writeRender(source: string, output: string): string;
+export declare function checkDrift(source: string, output: string): [boolean, string, string];
+export declare function main(argv?: string[]): number;
+//# sourceMappingURL=pack-render.d.ts.map

package/dist/packs/pack-render.js

@@ -0,0 +1,357 @@
+/** Port of scripts/pack_render.py — content-pack projection renderer (#1294, #1295). */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { contentRoot } from "../content-root.js";
+export function resolveRepoRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "..");
+}
+const REPO_ROOT = resolveRepoRoot();
+const CONTENT_ROOT = contentRoot(REPO_ROOT);
+export const DEFAULT_SOURCE = join(CONTENT_ROOT, "packs", "lessons", "lessons-pack-0.1.json");
+export const DEFAULT_OUTPUT = join(REPO_ROOT, "meta", "lessons.md");
+const LESSONS_BANNER = [
+    "<!-- AUTO-GENERATED by task packs:render -- DO NOT EDIT MANUALLY -->",
+    "<!-- Purpose: rendered lessons -->",
+    "<!-- Source of truth: packs/lessons/lessons-pack-0.1.json -->",
+    "<!-- Regenerate with: task packs:render -->",
+    "<!-- Edit the source, not this file. Slice instead of loading the whole file: task packs:slice lessons <name> (e.g. recent --since, by-tag --tag) -->",
+];
+const SKILLS_BANNER = [
+    "<!-- AUTO-GENERATED by task packs:render -- DO NOT EDIT MANUALLY -->",
+    "<!-- Purpose: rendered skill -->",
+    "<!-- Source of truth: packs/skills/skills-pack-0.1.json -->",
+    "<!-- Regenerate with: task packs:render -->",
+    "<!-- Edit the source, not this file. Slice instead of loading every SKILL.md: task packs:slice skills by-trigger --trigger <kw> (or list) -->",
+];
+const RULES_BANNER = [
+    "<!-- AUTO-GENERATED by task packs:render -- DO NOT EDIT MANUALLY -->",
+    "<!-- Purpose: rendered coding rules -->",
+    "<!-- Source of truth: packs/rules/rules-pack-0.1.json -->",
+    "<!-- Regenerate with: task packs:render -->",
+    "<!-- Edit the source, not this file. Slice instead of loading every coding doc: task packs:slice rules by-tier --tier <TIER> (or by-domain, list) -->",
+];
+const STRATEGIES_BANNER = [
+    "<!-- AUTO-GENERATED by task packs:render -- DO NOT EDIT MANUALLY -->",
+    "<!-- Purpose: rendered strategy -->",
+    "<!-- Source of truth: packs/strategies/strategies-pack-0.1.json -->",
+    "<!-- Regenerate with: task packs:render -->",
+    "<!-- Edit the source, not this file. Slice instead of loading every strategy: task packs:slice strategies by-trigger --trigger <kw> (or list) -->",
+];
+const PATTERNS_BANNER = [
+    "<!-- AUTO-GENERATED by task packs:render -- DO NOT EDIT MANUALLY -->",
+    "<!-- Purpose: rendered pattern -->",
+    "<!-- Source of truth: packs/patterns/patterns-pack-0.1.json -->",
+    "<!-- Regenerate with: task packs:render -->",
+    "<!-- Edit the source, not this file. Slice instead of loading every pattern: task packs:slice patterns by-trigger --trigger <kw> (or list) -->",
+];
+const SWARM_SPEC_BANNER = [
+    "<!-- AUTO-GENERATED by task packs:render -- DO NOT EDIT MANUALLY -->",
+    "<!-- Purpose: rendered swarm spec -->",
+    "<!-- Source of truth: packs/swarm-spec/swarm-spec-pack-0.1.json -->",
+    "<!-- Regenerate with: task packs:render -->",
+    "<!-- Edit the source, not this file. Slice instead of loading the whole spec: task packs:slice swarm-spec list -->",
+];
+export const BANNER = `${LESSONS_BANNER.join("\n")}\n`;
+export const DOC_TITLE = "# Lessons Learned";
+export const RENDER_REGISTRY = {
+    lessons: {
+        mode: "collection",
+        source: join(CONTENT_ROOT, "packs", "lessons", "lessons-pack-0.1.json"),
+        output: join(REPO_ROOT, "meta", "lessons.md"),
+        items_field: "lessons",
+        heading_field: "title",
+        body_field: "body",
+        title: DOC_TITLE,
+        banner: LESSONS_BANNER,
+    },
+    skills: {
+        mode: "documents",
+        doc_kind: "skill",
+        source: join(CONTENT_ROOT, "packs", "skills", "skills-pack-0.1.json"),
+        items_field: "skills",
+        name_field: "id",
+        description_field: "description",
+        path_field: "path",
+        body_field: "body",
+        banner: SKILLS_BANNER,
+    },
+    rules: {
+        mode: "documents",
+        doc_kind: "markdown",
+        source: join(CONTENT_ROOT, "packs", "rules", "rules-pack-0.1.json"),
+        items_field: "rules",
+        path_field: "path",
+        body_field: "body",
+        banner: RULES_BANNER,
+    },
+    strategies: {
+        mode: "documents",
+        doc_kind: "markdown",
+        source: join(CONTENT_ROOT, "packs", "strategies", "strategies-pack-0.1.json"),
+        items_field: "strategies",
+        path_field: "path",
+        body_field: "body",
+        banner: STRATEGIES_BANNER,
+    },
+    patterns: {
+        mode: "documents",
+        doc_kind: "markdown",
+        source: join(CONTENT_ROOT, "packs", "patterns", "patterns-pack-0.1.json"),
+        items_field: "patterns",
+        path_field: "path",
+        body_field: "body",
+        banner: PATTERNS_BANNER,
+    },
+    "swarm-spec": {
+        mode: "documents",
+        doc_kind: "markdown",
+        source: join(CONTENT_ROOT, "packs", "swarm-spec", "swarm-spec-pack-0.1.json"),
+        items_field: "entries",
+        path_field: "path",
+        body_field: "body",
+        banner: SWARM_SPEC_BANNER,
+    },
+};
+function bannerText(bannerLines) {
+    return `${bannerLines.join("\n")}\n`;
+}
+/** Mirrors Python ``textwrap.wrap`` with width 76 and default break behavior. */
+function textWrap(description, width = 76) {
+    if (description.length === 0) {
+        return [];
+    }
+    const words = description.split(/\s+/).filter((w) => w.length > 0);
+    if (words.length === 0) {
+        return [];
+    }
+    const lines = [];
+    let current = words[0];
+    for (let i = 1; i < words.length; i += 1) {
+        const word = words[i];
+        if (current.length + 1 + word.length <= width) {
+            current = `${current} ${word}`;
+        }
+        else {
+            lines.push(current);
+            current = word;
+        }
+    }
+    lines.push(current);
+    return lines;
+}
+export function renderCollection(pack, cfg) {
+    const parts = [bannerText(cfg.banner), `\n${cfg.title ?? ""}\n`];
+    const items = pack[cfg.items_field];
+    if (Array.isArray(items)) {
+        for (const entry of items) {
+            if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+                continue;
+            }
+            const record = entry;
+            const heading = record[cfg.heading_field ?? "title"];
+            const body = record[cfg.body_field];
+            parts.push(`\n## ${String(heading)}\n\n${String(body)}\n`);
+        }
+    }
+    return parts.join("");
+}
+function emitDescription(description) {
+    const wrapped = textWrap(description, 76);
+    const lines = ["description: >-"];
+    const bodyLines = wrapped.length > 0 ? wrapped : [""];
+    for (const line of bodyLines) {
+        lines.push(`  ${line}`);
+    }
+    return lines.join("\n");
+}
+export function renderSkillDocument(entry, cfg) {
+    const name = entry[cfg.name_field ?? "id"];
+    const description = entry[cfg.description_field ?? "description"];
+    const body = entry[cfg.body_field] ?? "";
+    const extra = entry.frontmatter_extra;
+    const extraBlock = typeof extra === "string" && extra.length > 0 ? `${extra}\n` : "";
+    const frontmatter = `---\nname: ${String(name)}\n${emitDescription(String(description))}\n${extraBlock}---\n`;
+    return `${frontmatter}${bannerText(cfg.banner)}\n${String(body)}`;
+}
+export function renderMarkdownDocument(entry, cfg) {
+    const body = entry[cfg.body_field] ?? "";
+    return `${bannerText(cfg.banner)}\n${String(body)}`;
+}
+const DOCUMENT_RENDERERS = {
+    skill: renderSkillDocument,
+    markdown: renderMarkdownDocument,
+};
+function targetsForPack(pack, cfg) {
+    if (cfg.mode === "collection") {
+        return [[cfg.output ?? "", renderCollection(pack, cfg)]];
+    }
+    const docRenderer = DOCUMENT_RENDERERS[cfg.doc_kind ?? "skill"] ?? renderSkillDocument;
+    const targets = [];
+    const items = pack[cfg.items_field];
+    if (!Array.isArray(items)) {
+        return targets;
+    }
+    for (const entry of items) {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            continue;
+        }
+        const record = entry;
+        if (!record[cfg.body_field]) {
+            continue;
+        }
+        const pathField = cfg.path_field ?? "path";
+        // Document projection targets (skills/rules/strategies/patterns) are
+        // shippable content -- they live under content/ in the source repo (#1875).
+        const outPath = join(CONTENT_ROOT, String(record[pathField]));
+        targets.push([outPath, docRenderer(record, cfg)]);
+    }
+    return targets;
+}
+export function collectTargets(packFilter) {
+    const targets = [];
+    for (const [name, cfg] of Object.entries(RENDER_REGISTRY)) {
+        if (packFilter !== undefined && packFilter !== null && name !== packFilter) {
+            continue;
+        }
+        if (!existsSync(cfg.source)) {
+            throw new Error(`pack source not found: ${cfg.source}`);
+        }
+        const pack = JSON.parse(readFileSync(cfg.source, "utf8"));
+        for (const [outPath, text] of targetsForPack(pack, cfg)) {
+            targets.push([name, outPath, text]);
+        }
+    }
+    return targets;
+}
+export function render(pack) {
+    return renderCollection(pack, RENDER_REGISTRY.lessons);
+}
+export function renderFile(source) {
+    if (!existsSync(source)) {
+        throw new Error(`pack source not found: ${source}`);
+    }
+    const pack = JSON.parse(readFileSync(source, "utf8"));
+    return render(pack);
+}
+export function writeRender(source, output) {
+    const text = renderFile(source);
+    mkdirSync(dirname(output), { recursive: true });
+    writeFileSync(output, text, "utf8");
+    return text;
+}
+export function checkDrift(source, output) {
+    const rendered = renderFile(source);
+    const current = existsSync(output) ? readFileSync(output, "utf8") : "";
+    return [rendered !== current, rendered, current];
+}
+function firstDiffLine(rendered, current) {
+    const rLines = rendered.split(/\r?\n/);
+    const cLines = current.split(/\r?\n/);
+    const limit = Math.min(rLines.length, cLines.length);
+    for (let i = 0; i < limit; i += 1) {
+        if (rLines[i] !== cLines[i]) {
+            return i + 1;
+        }
+    }
+    if (rLines.length !== cLines.length) {
+        return Math.min(rLines.length, cLines.length) + 1;
+    }
+    return 0;
+}
+function runLegacy(source, output, check) {
+    if (check) {
+        const [hasDrift, rendered, current] = checkDrift(source, output);
+        if (hasDrift) {
+            const line = firstDiffLine(rendered, current);
+            process.stderr.write(`pack-drift: ${output} is out of sync with ${source} ` +
+                `(first difference near line ${line}). ` +
+                "Run `task packs:render` to regenerate.\n");
+            return 1;
+        }
+        process.stdout.write(`pack-drift: ${output} is in sync with ${source}.\n`);
+        return 0;
+    }
+    writeRender(source, output);
+    process.stdout.write(`Rendered ${output} from ${source}\n`);
+    return 0;
+}
+function runMultipack(packFilter, check) {
+    const targets = collectTargets(packFilter);
+    if (check) {
+        const drifted = [];
+        for (const [_name, outPath, text] of targets) {
+            const current = existsSync(outPath) ? readFileSync(outPath, "utf8") : "";
+            if (text !== current) {
+                drifted.push(outPath);
+            }
+        }
+        if (drifted.length > 0) {
+            const listing = drifted.join(", ");
+            process.stderr.write(`pack-drift: ${drifted.length} projection(s) out of sync: ${listing}. ` +
+                "Run `task packs:render` to regenerate.\n");
+            return 1;
+        }
+        process.stdout.write(`pack-drift: all ${targets.length} projection(s) in sync.\n`);
+        return 0;
+    }
+    for (const [_name, outPath, text] of targets) {
+        mkdirSync(dirname(outPath), { recursive: true });
+        writeFileSync(outPath, text, "utf8");
+    }
+    process.stdout.write(`Rendered ${targets.length} projection(s) across ${Object.keys(RENDER_REGISTRY).length} pack(s).\n`);
+    return 0;
+}
+function parseArgs(argv) {
+    const parsed = {
+        source: null,
+        output: null,
+        pack: null,
+        check: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--check") {
+            parsed.check = true;
+        }
+        else if (arg === "--source") {
+            parsed.source = argv[i + 1] ?? null;
+            i += 1;
+        }
+        else if (arg.startsWith("--source=")) {
+            parsed.source = arg.slice("--source=".length);
+        }
+        else if (arg === "--output") {
+            parsed.output = argv[i + 1] ?? null;
+            i += 1;
+        }
+        else if (arg.startsWith("--output=")) {
+            parsed.output = arg.slice("--output=".length);
+        }
+        else if (arg === "--pack") {
+            parsed.pack = argv[i + 1] ?? null;
+            i += 1;
+        }
+        else if (arg.startsWith("--pack=")) {
+            parsed.pack = arg.slice("--pack=".length);
+        }
+    }
+    return parsed;
+}
+export function main(argv) {
+    const args = parseArgs(argv ?? process.argv.slice(2));
+    try {
+        if (args.source !== null || args.output !== null) {
+            const source = args.source ?? DEFAULT_SOURCE;
+            const output = args.output ?? DEFAULT_OUTPUT;
+            return runLegacy(source, output, args.check);
+        }
+        return runMultipack(args.pack, args.check);
+    }
+    catch (exc) {
+        const message = exc instanceof Error ? exc.message : String(exc);
+        process.stderr.write(`error: ${message}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=pack-render.js.map

package/dist/packs/packs-slice.d.ts

@@ -0,0 +1,58 @@
+/** Port of scripts/packs_slice.py — named slice access to content packs (#1283, #1294). */
+export declare function resolveRepoRoot(): string;
+export interface PackRegistryPaths {
+    readonly source: string;
+    readonly schema: string;
+}
+export declare const PACK_REGISTRY: Record<string, PackRegistryPaths>;
+export declare const PACKS_DIR: string;
+export declare const SCHEMAS_DIR: string;
+export declare const DEFAULT_DISPLAY: Record<string, unknown>;
+export declare class UsageError extends Error {
+    readonly message: string;
+    readonly suggestion: string | null;
+    constructor(message: string, suggestion?: string | null);
+}
+export declare function sha256File(path: string): string;
+export declare function isValidSince(value: string): boolean;
+/** Simple ratio-based did-you-mean (n=1, cutoff 0.6 — mirrors difflib.get_close_matches). */
+export declare function getCloseMatches(word: string, possibilities: readonly string[], n?: number, cutoff?: number): string[];
+export declare function resolvePack(packName: string): [string, string];
+export declare function loadDisplay(schemaPath: string): Record<string, unknown>;
+export declare function loadRegistry(schemaPath: string): Record<string, Record<string, unknown>>;
+export declare function loadSource(sourcePath: string): Record<string, unknown>;
+export declare function resolveDottedPath(data: unknown, dotted: string): unknown;
+export declare function applySince(entries: Array<Record<string, unknown>>, since: string): Array<Record<string, unknown>>;
+export declare function applyTags(entries: Array<Record<string, unknown>>, tags: string[]): Array<Record<string, unknown>>;
+export declare function applyTriggers(entries: Array<Record<string, unknown>>, triggers: string[]): Array<Record<string, unknown>>;
+export declare function applyScalar(entries: Array<Record<string, unknown>>, field: string, values: string[]): Array<Record<string, unknown>>;
+export declare function applyIssueRefs(entries: Array<Record<string, unknown>>, issues: string[]): Array<Record<string, unknown>>;
+export declare function applySelect(entries: Array<Record<string, unknown>>, select: Record<string, unknown>): Array<Record<string, unknown>>;
+export interface SliceResult {
+    pack: string;
+    slice: string;
+    source: string;
+    source_sha: string;
+    count: number;
+    results: Array<Record<string, unknown>>;
+}
+export declare function slicePack(packId: string, sliceName: string, registry: Record<string, Record<string, unknown>>, sourceData: Record<string, unknown>, sourcePath: string, options?: {
+    since?: string | null;
+    tags?: string[] | null;
+    triggers?: string[] | null;
+    tiers?: string[] | null;
+    domains?: string[] | null;
+    issues?: string[] | null;
+    ids?: string[] | null;
+    repoRoot?: string;
+}): SliceResult;
+export declare function listSlices(packId: string, registry: Record<string, Record<string, unknown>>, sourcePath: string, repoRoot?: string): Record<string, unknown>;
+export declare function oneLine(text: string): string;
+export declare function discoverPacks(packsDir?: string, schemasDir?: string, repoRoot?: string): Array<Record<string, unknown>>;
+export declare function listPacks(packsDir?: string, schemasDir?: string, repoRoot?: string): Record<string, unknown>;
+export declare function formatListPacksText(payload: Record<string, unknown>): string;
+export declare function formatSliceText(result: SliceResult, display?: Record<string, unknown> | null): string;
+export declare function formatListText(payload: Record<string, unknown>): string;
+export declare function collectTags(raw: string[]): string[];
+export declare function main(argv?: string[]): number;
+//# sourceMappingURL=packs-slice.d.ts.map