@shrkcrft/generator 0.1.0-alpha.2

package/dist/generator-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-engine.d.ts","sourceRoot":"","sources":["../src/generator-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;CACjC;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CA2DrC"}

package/dist/generator-engine.js

@@ -0,0 +1,74 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { AppErrorImpl, ERROR_CODES, err, ok, } from '@shrkcrft/core';
+import { planGeneration } from "./dry-run.js";
+import { FileChangeType } from "./file-change.js";
+export function generate(template, request) {
+    const dryRun = planGeneration(template, request);
+    const plan = dryRun.plan;
+    if (!request.write) {
+        return ok({
+            plan,
+            summary: {
+                written: 0,
+                skipped: plan.changes.filter((c) => c.type === FileChangeType.Skip).length,
+                conflicts: plan.changes.filter((c) => c.type === FileChangeType.Conflict).length,
+                totalBytes: 0,
+            },
+            written: [],
+        });
+    }
+    if (plan.hasConflicts) {
+        return err(new AppErrorImpl(ERROR_CODES.TARGET_FILE_EXISTS, 'Generation refused: plan has conflicts (use --force / different overwrite strategy)', { details: { conflicts: plan.changes.filter((c) => c.type === FileChangeType.Conflict) } }));
+    }
+    const written = [];
+    let totalBytes = 0;
+    let skipped = 0;
+    for (const change of plan.changes) {
+        if (change.type === FileChangeType.Skip) {
+            skipped += 1;
+            continue;
+        }
+        if (isWriteableChange(change.type)) {
+            try {
+                mkdirSync(dirname(change.absolutePath), { recursive: true });
+                writeFileSync(change.absolutePath, change.contents, 'utf8');
+                written.push(change);
+                totalBytes += change.sizeBytes;
+            }
+            catch (e) {
+                return err(new AppErrorImpl(ERROR_CODES.FILE_WRITE_ERROR, `Failed to write ${change.absolutePath}`, { details: { path: change.absolutePath }, cause: e }));
+            }
+        }
+    }
+    return ok({
+        plan,
+        summary: { written: written.length, skipped, conflicts: 0, totalBytes },
+        written,
+    });
+}
+/**
+ * Every kind whose evaluation produces final-byte `contents` that must be
+ * written to disk. Skip + Conflict are explicitly excluded.
+ */
+function isWriteableChange(type) {
+    switch (type) {
+        case FileChangeType.Create:
+        case FileChangeType.Update:
+        case FileChangeType.Append:
+        case FileChangeType.InsertAfter:
+        case FileChangeType.InsertBefore:
+        case FileChangeType.Replace:
+        case FileChangeType.Export:
+            return true;
+        case FileChangeType.Skip:
+        case FileChangeType.Conflict:
+            return false;
+        case FileChangeType.RenameFolder:
+        case FileChangeType.DeleteFolder:
+            // Folder ops require dedicated apply-time handling; the file-byte
+            // writer never produces them. apply rejects them unless `--allow-folder-ops`
+            // and the safety check is green.
+            return false;
+    }
+}

package/dist/grounding/extracted-plan.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Extractor-derived view of an external plan / spec.
+ *
+ * Any plan format (`sharkcraft.spec/v1`, a team's loose
+ * frontmatter, etc.) reduces to this shape so the shared validation
+ * pipeline in `@shrkcrft/inspector` can check it against the live
+ * workspace.
+ *
+ * Every field is optional. Extractors populate what they can read
+ * from the source; the validator reports gaps as warnings.
+ */
+export declare const EXTRACTED_PLAN_SCHEMA = "sharkcraft.extracted-plan/v1";
+export interface IExtractedAcceptanceCriterion {
+    readonly id?: string;
+    readonly text: string;
+    readonly verifiedBy?: readonly string[];
+}
+export interface IExtractedProposedTemplate {
+    readonly templateId: string;
+    readonly variables?: Readonly<Record<string, string>>;
+}
+export interface IExtractedPlan {
+    readonly schema: typeof EXTRACTED_PLAN_SCHEMA;
+    /** Source path (relative or absolute). May be empty when the plan was passed inline. */
+    readonly source: string;
+    /** Which extractor produced this view. */
+    readonly extractorId: string;
+    readonly intent?: string;
+    readonly motivation?: string;
+    readonly title?: string;
+    readonly affectedFiles?: readonly string[];
+    readonly affectedPackages?: readonly string[];
+    readonly acceptanceCriteria?: readonly IExtractedAcceptanceCriterion[];
+    readonly relevantRules?: readonly string[];
+    readonly relevantKnowledge?: readonly string[];
+    readonly relevantPaths?: readonly string[];
+    readonly proposedTemplates?: readonly IExtractedProposedTemplate[];
+    readonly verificationCommandIds?: readonly string[];
+    /** Original parsed structure (extractor-specific), for traceability. */
+    readonly raw: unknown;
+}
+//# sourceMappingURL=extracted-plan.d.ts.map

package/dist/grounding/extracted-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extracted-plan.d.ts","sourceRoot":"","sources":["../../src/grounding/extracted-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,qBAAqB,CAAC;IAC9C,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACnE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpD,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB"}

package/dist/grounding/extracted-plan.js

@@ -0,0 +1,12 @@
+/**
+ * Extractor-derived view of an external plan / spec.
+ *
+ * Any plan format (`sharkcraft.spec/v1`, a team's loose
+ * frontmatter, etc.) reduces to this shape so the shared validation
+ * pipeline in `@shrkcrft/inspector` can check it against the live
+ * workspace.
+ *
+ * Every field is optional. Extractors populate what they can read
+ * from the source; the validator reports gaps as warnings.
+ */
+export const EXTRACTED_PLAN_SCHEMA = 'sharkcraft.extracted-plan/v1';

package/dist/grounding/extractor-registry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Built-in extractor registry.
+ *
+ * Two extractors, no plugin-api surface. Pack-contributed extractors
+ * are explicitly out of scope for now — revisit when a real pack
+ * needs one.
+ */
+import { MARKDOWN_FRONTMATTER_LOOSE_EXTRACTOR_ID } from './extractors/markdown-frontmatter-loose.js';
+import { SHARKCRAFT_SPEC_V1_EXTRACTOR_ID } from './extractors/sharkcraft-spec-v1.js';
+import type { IPlanExtractor } from './extractor.js';
+export declare const BUILTIN_EXTRACTORS: readonly IPlanExtractor[];
+export declare function getExtractorById(id: string): IPlanExtractor | null;
+/**
+ * Pick the highest-confidence extractor for a path. Order:
+ *   1. The first extractor whose `accepts(path)` returns true,
+ *      preferring `sharkcraft.spec/v1` over `markdown-frontmatter-loose`.
+ *   2. Otherwise, null — caller must pick explicitly.
+ */
+export declare function pickExtractor(path: string): IPlanExtractor | null;
+export { MARKDOWN_FRONTMATTER_LOOSE_EXTRACTOR_ID, SHARKCRAFT_SPEC_V1_EXTRACTOR_ID, };
+//# sourceMappingURL=extractor-registry.d.ts.map

package/dist/grounding/extractor-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor-registry.d.ts","sourceRoot":"","sources":["../../src/grounding/extractor-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,uCAAuC,EAExC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,+BAA+B,EAEhC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAGtD,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAKjE;AAED,OAAO,EACL,uCAAuC,EACvC,+BAA+B,GAChC,CAAC"}

package/dist/grounding/extractor-registry.js

@@ -0,0 +1,30 @@
+/**
+ * Built-in extractor registry.
+ *
+ * Two extractors, no plugin-api surface. Pack-contributed extractors
+ * are explicitly out of scope for now — revisit when a real pack
+ * needs one.
+ */
+import { MARKDOWN_FRONTMATTER_LOOSE_EXTRACTOR_ID, markdownFrontmatterLooseExtractor, } from "./extractors/markdown-frontmatter-loose.js";
+import { SHARKCRAFT_SPEC_V1_EXTRACTOR_ID, sharkcraftSpecV1Extractor, } from "./extractors/sharkcraft-spec-v1.js";
+export const BUILTIN_EXTRACTORS = Object.freeze([
+    sharkcraftSpecV1Extractor,
+    markdownFrontmatterLooseExtractor,
+]);
+export function getExtractorById(id) {
+    return BUILTIN_EXTRACTORS.find((e) => e.id === id) ?? null;
+}
+/**
+ * Pick the highest-confidence extractor for a path. Order:
+ *   1. The first extractor whose `accepts(path)` returns true,
+ *      preferring `sharkcraft.spec/v1` over `markdown-frontmatter-loose`.
+ *   2. Otherwise, null — caller must pick explicitly.
+ */
+export function pickExtractor(path) {
+    for (const e of BUILTIN_EXTRACTORS) {
+        if (e.accepts(path))
+            return e;
+    }
+    return null;
+}
+export { MARKDOWN_FRONTMATTER_LOOSE_EXTRACTOR_ID, SHARKCRAFT_SPEC_V1_EXTRACTOR_ID, };

package/dist/grounding/extractor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `IPlanExtractor` contract.
+ *
+ * An extractor turns an external plan/spec file (markdown, JSON, …)
+ * into an `IExtractedPlan` view for the shared validator. Extractors
+ * are read-only — they never modify the source.
+ */
+import type { AppError, Result } from '@shrkcrft/core';
+import type { IExtractedPlan } from './extracted-plan.js';
+/** Field-map: external key → canonical IExtractedPlan key. */
+export type ExtractorFieldMap = Readonly<Record<string, string>>;
+export interface IExtractorContext {
+    readonly source: string;
+    readonly fieldMap?: ExtractorFieldMap;
+}
+export interface IPlanExtractor {
+    readonly id: string;
+    readonly description: string;
+    /** Quick check: does this extractor accept this file path? */
+    readonly accepts: (path: string) => boolean;
+    /** Parse the raw file content into the canonical view. */
+    readonly extract: (raw: string, ctx: IExtractorContext) => Result<IExtractedPlan, AppError>;
+}
+//# sourceMappingURL=extractor.d.ts.map

package/dist/grounding/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/grounding/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,KAAK,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;CAC7F"}

package/dist/grounding/extractor.js

@@ -0,0 +1,8 @@
+/**
+ * `IPlanExtractor` contract.
+ *
+ * An extractor turns an external plan/spec file (markdown, JSON, …)
+ * into an `IExtractedPlan` view for the shared validator. Extractors
+ * are read-only — they never modify the source.
+ */
+export {};

package/dist/grounding/extractors/markdown-frontmatter-loose.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `markdown-frontmatter-loose` extractor.
+ *
+ * Accepts any markdown file with YAML-shaped frontmatter (delimited
+ * by `---`). Reuses the spec frontmatter parser. Field-map remaps
+ * team-specific keys to canonical IExtractedPlan keys, with one
+ * documented level of nesting (`affectedAreas.files`, etc.).
+ *
+ * Designed for: Claude-SDD-plugin output, Cursor / Aider plans,
+ * homegrown markdown plan templates. The parser is tolerant of
+ * unknown keys — they pass through into `raw` for traceability but
+ * do not become IExtractedPlan fields unless field-mapped.
+ */
+import type { IPlanExtractor } from '../extractor.js';
+export declare const MARKDOWN_FRONTMATTER_LOOSE_EXTRACTOR_ID = "markdown-frontmatter-loose";
+export declare const markdownFrontmatterLooseExtractor: IPlanExtractor;
+//# sourceMappingURL=markdown-frontmatter-loose.d.ts.map

package/dist/grounding/extractors/markdown-frontmatter-loose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-frontmatter-loose.d.ts","sourceRoot":"","sources":["../../../src/grounding/extractors/markdown-frontmatter-loose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,KAAK,EAAwC,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5F,eAAO,MAAM,uCAAuC,+BAA+B,CAAC;AAkBpF,eAAO,MAAM,iCAAiC,EAAE,cAuC/C,CAAC"}

package/dist/grounding/extractors/markdown-frontmatter-loose.js

@@ -0,0 +1,160 @@
+/**
+ * `markdown-frontmatter-loose` extractor.
+ *
+ * Accepts any markdown file with YAML-shaped frontmatter (delimited
+ * by `---`). Reuses the spec frontmatter parser. Field-map remaps
+ * team-specific keys to canonical IExtractedPlan keys, with one
+ * documented level of nesting (`affectedAreas.files`, etc.).
+ *
+ * Designed for: Claude-SDD-plugin output, Cursor / Aider plans,
+ * homegrown markdown plan templates. The parser is tolerant of
+ * unknown keys — they pass through into `raw` for traceability but
+ * do not become IExtractedPlan fields unless field-mapped.
+ */
+import { AppErrorImpl, ERROR_CODES, err, ok } from '@shrkcrft/core';
+import { splitSpecMd } from "../../spec/spec-frontmatter.js";
+import { EXTRACTED_PLAN_SCHEMA, } from "../extracted-plan.js";
+export const MARKDOWN_FRONTMATTER_LOOSE_EXTRACTOR_ID = 'markdown-frontmatter-loose';
+const CANONICAL_KEYS = new Set([
+    'intent',
+    'motivation',
+    'title',
+    'affectedFiles',
+    'affectedAreas.files',
+    'affectedPackages',
+    'affectedAreas.packages',
+    'acceptanceCriteria',
+    'relevantRules',
+    'relevantKnowledge',
+    'relevantPaths',
+    'proposedTemplates',
+    'verificationCommandIds',
+]);
+export const markdownFrontmatterLooseExtractor = {
+    id: MARKDOWN_FRONTMATTER_LOOSE_EXTRACTOR_ID,
+    description: 'Any markdown file with YAML-shaped frontmatter. Use --field-map to remap keys.',
+    accepts(path) {
+        return path.endsWith('.md') || path.endsWith('.mdx');
+    },
+    extract(raw, ctx) {
+        const split = splitSpecMd(raw);
+        if (!split.ok) {
+            return err(new AppErrorImpl(ERROR_CODES.INVALID_INPUT, 'markdown-frontmatter-loose: file is missing `---` frontmatter delimiters', { cause: split.error }));
+        }
+        const fm = split.value.frontmatter.fields;
+        const fieldMap = ctx.fieldMap ?? {};
+        const resolved = applyFieldMap(fm, fieldMap);
+        const view = {
+            schema: EXTRACTED_PLAN_SCHEMA,
+            source: ctx.source,
+            extractorId: MARKDOWN_FRONTMATTER_LOOSE_EXTRACTOR_ID,
+            intent: asString(resolved.intent),
+            motivation: asString(resolved.motivation),
+            title: asString(resolved.title),
+            affectedFiles: readScalarArray(resolved.affectedFiles ?? resolved['affectedAreas.files']),
+            affectedPackages: readScalarArray(resolved.affectedPackages ?? resolved['affectedAreas.packages']),
+            acceptanceCriteria: readAcceptance(resolved.acceptanceCriteria),
+            relevantRules: readScalarArray(resolved.relevantRules),
+            relevantKnowledge: readScalarArray(resolved.relevantKnowledge),
+            relevantPaths: readScalarArray(resolved.relevantPaths),
+            proposedTemplates: readProposedTemplates(resolved.proposedTemplates),
+            verificationCommandIds: readScalarArray(resolved.verificationCommandIds),
+            raw: fm,
+        };
+        return ok(view);
+    },
+};
+function applyFieldMap(fm, fieldMap) {
+    if (Object.keys(fieldMap).length === 0) {
+        return { ...fm };
+    }
+    const out = { ...fm };
+    for (const [externalKey, canonicalKey] of Object.entries(fieldMap)) {
+        if (!CANONICAL_KEYS.has(canonicalKey))
+            continue;
+        const value = fm[externalKey];
+        if (value === undefined)
+            continue;
+        out[canonicalKey] = value;
+    }
+    return out;
+}
+function asString(v) {
+    if (typeof v === 'string')
+        return v.length > 0 ? v : undefined;
+    if (typeof v === 'number' || typeof v === 'boolean')
+        return String(v);
+    return undefined;
+}
+function readScalarArray(v) {
+    if (v === undefined || v === null)
+        return undefined;
+    if (Array.isArray(v)) {
+        const out = v
+            .map((x) => (typeof x === 'string' ? x : typeof x === 'number' || typeof x === 'boolean' ? String(x) : ''))
+            .filter((s) => s.length > 0);
+        return out.length > 0 ? out : undefined;
+    }
+    if (typeof v === 'string') {
+        const out = v
+            .split(',')
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        return out.length > 0 ? out : undefined;
+    }
+    return undefined;
+}
+function readAcceptance(v) {
+    if (!Array.isArray(v))
+        return undefined;
+    const out = [];
+    for (const item of v) {
+        if (typeof item === 'string' && item.length > 0) {
+            out.push({ text: item });
+            continue;
+        }
+        if (item && typeof item === 'object') {
+            const obj = item;
+            const text = typeof obj['text'] === 'string' ? obj['text'] : undefined;
+            if (!text)
+                continue;
+            const id = typeof obj['id'] === 'string' ? obj['id'] : undefined;
+            const verifiedBy = readScalarArray(obj['verifiedBy']);
+            out.push({
+                ...(id !== undefined ? { id } : {}),
+                text,
+                ...(verifiedBy !== undefined ? { verifiedBy } : {}),
+            });
+        }
+    }
+    return out.length > 0 ? out : undefined;
+}
+function readProposedTemplates(v) {
+    if (!Array.isArray(v))
+        return undefined;
+    const out = [];
+    for (const item of v) {
+        if (typeof item === 'string' && item.length > 0) {
+            out.push({ templateId: item });
+            continue;
+        }
+        if (item && typeof item === 'object') {
+            const obj = item;
+            const templateId = typeof obj['templateId'] === 'string' ? obj['templateId'] : undefined;
+            if (!templateId)
+                continue;
+            const rawVars = obj['variables'];
+            const variables = {};
+            if (rawVars && typeof rawVars === 'object' && !Array.isArray(rawVars)) {
+                for (const [k, val] of Object.entries(rawVars)) {
+                    variables[k] = typeof val === 'string' ? val : String(val ?? '');
+                }
+            }
+            out.push({
+                templateId,
+                ...(Object.keys(variables).length > 0 ? { variables } : {}),
+            });
+        }
+    }
+    return out.length > 0 ? out : undefined;
+}

package/dist/grounding/extractors/sharkcraft-spec-v1.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `sharkcraft.spec/v1` extractor.
+ *
+ * Wraps the spec parser + derive pipeline and projects the result onto
+ * the canonical `IExtractedPlan` shape. This is the high-confidence
+ * path: when the team is already writing `sharkcraft.spec/v1` specs,
+ * no information is lost in translation.
+ */
+import type { IPlanExtractor } from '../extractor.js';
+export declare const SHARKCRAFT_SPEC_V1_EXTRACTOR_ID = "sharkcraft.spec/v1";
+export declare const sharkcraftSpecV1Extractor: IPlanExtractor;
+//# sourceMappingURL=sharkcraft-spec-v1.d.ts.map

package/dist/grounding/extractors/sharkcraft-spec-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharkcraft-spec-v1.d.ts","sourceRoot":"","sources":["../../../src/grounding/extractors/sharkcraft-spec-v1.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEzE,eAAO,MAAM,+BAA+B,uBAAuB,CAAC;AAEpE,eAAO,MAAM,yBAAyB,EAAE,cAsCvC,CAAC"}

package/dist/grounding/extractors/sharkcraft-spec-v1.js

@@ -0,0 +1,56 @@
+/**
+ * `sharkcraft.spec/v1` extractor.
+ *
+ * Wraps the spec parser + derive pipeline and projects the result onto
+ * the canonical `IExtractedPlan` shape. This is the high-confidence
+ * path: when the team is already writing `sharkcraft.spec/v1` specs,
+ * no information is lost in translation.
+ */
+import { AppErrorImpl, ERROR_CODES, err, ok } from '@shrkcrft/core';
+import { deriveSpecJson } from "../../spec/spec-derive.js";
+import { splitSpecMd } from "../../spec/spec-frontmatter.js";
+import { EXTRACTED_PLAN_SCHEMA } from "../extracted-plan.js";
+export const SHARKCRAFT_SPEC_V1_EXTRACTOR_ID = 'sharkcraft.spec/v1';
+export const sharkcraftSpecV1Extractor = {
+    id: SHARKCRAFT_SPEC_V1_EXTRACTOR_ID,
+    description: 'sharkcraft.spec/v1 format — wraps the spec.md parser.',
+    accepts(path) {
+        return path.endsWith('spec.md');
+    },
+    extract(raw, ctx) {
+        const split = splitSpecMd(raw);
+        if (!split.ok)
+            return err(split.error);
+        const derived = deriveSpecJson(split.value);
+        if (!derived.ok)
+            return err(derived.error);
+        const spec = derived.value;
+        const view = {
+            schema: EXTRACTED_PLAN_SCHEMA,
+            source: ctx.source,
+            extractorId: SHARKCRAFT_SPEC_V1_EXTRACTOR_ID,
+            intent: spec.intent || undefined,
+            motivation: spec.motivation || undefined,
+            title: spec.title || undefined,
+            affectedFiles: spec.affectedAreas.files,
+            affectedPackages: spec.affectedAreas.packages,
+            acceptanceCriteria: spec.acceptanceCriteria.map((ac) => ({
+                id: ac.id,
+                text: ac.text,
+                verifiedBy: ac.verifiedBy,
+            })),
+            relevantRules: spec.relevantRules,
+            relevantKnowledge: spec.relevantKnowledge,
+            relevantPaths: spec.relevantPaths,
+            proposedTemplates: spec.proposedTemplates.map((t) => ({
+                templateId: t.templateId,
+                variables: t.variables,
+            })),
+            verificationCommandIds: spec.verificationCommands.map((v) => v.id),
+            raw: spec,
+        };
+        return ok(view);
+    },
+};
+void AppErrorImpl;
+void ERROR_CODES;

package/dist/grounding/index.d.ts

@@ -0,0 +1,6 @@
+export * from './extracted-plan.js';
+export * from './extractor.js';
+export * from './extractor-registry.js';
+export * from './extractors/sharkcraft-spec-v1.js';
+export * from './extractors/markdown-frontmatter-loose.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/grounding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grounding/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC"}

package/dist/grounding/index.js

@@ -0,0 +1,5 @@
+export * from "./extracted-plan.js";
+export * from "./extractor.js";
+export * from "./extractor-registry.js";
+export * from "./extractors/sharkcraft-spec-v1.js";
+export * from "./extractors/markdown-frontmatter-loose.js";

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export * from './generation-request.js';
+export * from './generation-plan.js';
+export * from './file-change.js';
+export * from './generator-engine.js';
+export * from './dry-run.js';
+export * from './overwrite-strategy.js';
+export * from './conflict-handler.js';
+export * from './naming-strategy.js';
+export * from './saved-plan.js';
+export * from './plan-signing.js';
+export * from './planned-change.js';
+export * from './folder-safety.js';
+export * from './folder-apply.js';
+export * from './synthetic-plan.js';
+export * from './spec/index.js';
+export * from './grounding/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export * from "./generation-request.js";
+export * from "./generation-plan.js";
+export * from "./file-change.js";
+export * from "./generator-engine.js";
+export * from "./dry-run.js";
+export * from "./overwrite-strategy.js";
+export * from "./conflict-handler.js";
+export * from "./naming-strategy.js";
+export * from "./saved-plan.js";
+export * from "./plan-signing.js";
+export * from "./planned-change.js";
+export * from "./folder-safety.js";
+export * from "./folder-apply.js";
+export * from "./synthetic-plan.js";
+export * from "./spec/index.js";
+export * from "./grounding/index.js";

package/dist/naming-strategy.d.ts

@@ -0,0 +1,5 @@
+import { NamingStrategy } from './overwrite-strategy.js';
+import type { TemplateVariableValues } from '@shrkcrft/templates';
+export declare function applyNaming(name: string, strategy: NamingStrategy): string;
+export declare function buildNameVariables(name: string): TemplateVariableValues;
+//# sourceMappingURL=naming-strategy.d.ts.map

package/dist/naming-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-strategy.d.ts","sourceRoot":"","sources":["../src/naming-strategy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAc1E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAUvE"}

package/dist/naming-strategy.js

@@ -0,0 +1,28 @@
+import { toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from '@shrkcrft/core';
+import { NamingStrategy } from "./overwrite-strategy.js";
+export function applyNaming(name, strategy) {
+    switch (strategy) {
+        case NamingStrategy.Kebab:
+            return toKebabCase(name);
+        case NamingStrategy.Pascal:
+            return toPascalCase(name);
+        case NamingStrategy.Camel:
+            return toCamelCase(name);
+        case NamingStrategy.Snake:
+            return toSnakeCase(name);
+        case NamingStrategy.AsIs:
+        default:
+            return name;
+    }
+}
+export function buildNameVariables(name) {
+    return {
+        name: toKebabCase(name),
+        kebab: toKebabCase(name),
+        pascal: toPascalCase(name),
+        camel: toCamelCase(name),
+        snake: toSnakeCase(name),
+        className: toPascalCase(name),
+        fileName: toKebabCase(name),
+    };
+}

package/dist/overwrite-strategy.d.ts

@@ -0,0 +1,14 @@
+export declare enum OverwriteStrategy {
+    Never = "never",
+    Ask = "ask",
+    Overwrite = "overwrite",
+    MergeLater = "merge-later"
+}
+export declare enum NamingStrategy {
+    AsIs = "as-is",
+    Kebab = "kebab",
+    Pascal = "pascal",
+    Camel = "camel",
+    Snake = "snake"
+}
+//# sourceMappingURL=overwrite-strategy.d.ts.map

package/dist/overwrite-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overwrite-strategy.d.ts","sourceRoot":"","sources":["../src/overwrite-strategy.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,SAAS,cAAc;IACvB,UAAU,gBAAgB;CAC3B;AAED,oBAAY,cAAc;IACxB,IAAI,UAAU;IACd,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,KAAK,UAAU;CAChB"}

package/dist/overwrite-strategy.js

@@ -0,0 +1,15 @@
+export var OverwriteStrategy;
+(function (OverwriteStrategy) {
+    OverwriteStrategy["Never"] = "never";
+    OverwriteStrategy["Ask"] = "ask";
+    OverwriteStrategy["Overwrite"] = "overwrite";
+    OverwriteStrategy["MergeLater"] = "merge-later";
+})(OverwriteStrategy || (OverwriteStrategy = {}));
+export var NamingStrategy;
+(function (NamingStrategy) {
+    NamingStrategy["AsIs"] = "as-is";
+    NamingStrategy["Kebab"] = "kebab";
+    NamingStrategy["Pascal"] = "pascal";
+    NamingStrategy["Camel"] = "camel";
+    NamingStrategy["Snake"] = "snake";
+})(NamingStrategy || (NamingStrategy = {}));