codeloop-mcp-server 0.1.14 → 0.1.16

package/dist/prompt_manager/state_machine.d.ts

@@ -0,0 +1,55 @@
+/**
+ * App-level state machine for multi-section orchestration.
+ *
+ * Layered above the per-section state machine in `state/section_registry.ts`.
+ * The app-level machine answers a single question: "what prompt layer should
+ * the agent receive next?" Inputs are coarse-grained events emitted by the
+ * MCP tools (`section_status`, `verify`, `gate_check`, `integration_check`,
+ * `replan`).
+ */
+import type { PromptLayer } from "./templates.js";
+export type AppState = "idle" | "planning" | "implementing" | "repairing" | "integrating" | "released";
+export type AppEvent = {
+    type: "user_goal_received";
+} | {
+    type: "spec_ready";
+} | {
+    type: "section_started";
+} | {
+    type: "verify_failed";
+} | {
+    type: "verify_passed";
+} | {
+    type: "gate_failed";
+} | {
+    type: "gate_passed";
+} | {
+    type: "integration_due";
+} | {
+    type: "integration_passed";
+} | {
+    type: "integration_failed";
+} | {
+    type: "replan_requested";
+} | {
+    type: "all_sections_ready";
+};
+export interface Transition {
+    from: AppState;
+    event: AppEvent["type"];
+    to: AppState;
+    prompt_layer: PromptLayer;
+}
+export interface StepResult {
+    next_state: AppState;
+    prompt_layer: PromptLayer;
+    matched: boolean;
+}
+/**
+ * Compute the next app state and the prompt layer the agent should receive.
+ * If no transition matches, the state is preserved and `matched` is false; the
+ * caller should treat that as a no-op (continue the current loop).
+ */
+export declare function step(current: AppState, event: AppEvent): StepResult;
+export declare function listTransitions(): readonly Transition[];
+//# sourceMappingURL=state_machine.d.ts.map

package/dist/prompt_manager/state_machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_machine.d.ts","sourceRoot":"","sources":["../../src/prompt_manager/state_machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,UAAU,GACV,cAAc,GACd,WAAW,GACX,aAAa,GACb,UAAU,CAAC;AAEf,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEnC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxB,EAAE,EAAE,QAAQ,CAAC;IACb,YAAY,EAAE,WAAW,CAAC;CAC3B;AAuBD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,QAAQ,CAAC;IACrB,YAAY,EAAE,WAAW,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU,CAOnE;AAiBD,wBAAgB,eAAe,IAAI,SAAS,UAAU,EAAE,CAEvD"}

package/dist/prompt_manager/state_machine.js

@@ -0,0 +1,60 @@
+/**
+ * App-level state machine for multi-section orchestration.
+ *
+ * Layered above the per-section state machine in `state/section_registry.ts`.
+ * The app-level machine answers a single question: "what prompt layer should
+ * the agent receive next?" Inputs are coarse-grained events emitted by the
+ * MCP tools (`section_status`, `verify`, `gate_check`, `integration_check`,
+ * `replan`).
+ */
+const TRANSITIONS = [
+    { from: "idle", event: "user_goal_received", to: "planning", prompt_layer: "master_human" },
+    { from: "planning", event: "spec_ready", to: "implementing", prompt_layer: "planning" },
+    { from: "implementing", event: "section_started", to: "implementing", prompt_layer: "section_implement" },
+    { from: "implementing", event: "verify_failed", to: "repairing", prompt_layer: "repair" },
+    { from: "implementing", event: "gate_failed", to: "repairing", prompt_layer: "repair" },
+    // Happy-path: verify/gate pass on the first try (no detour through repairing).
+    { from: "implementing", event: "verify_passed", to: "implementing", prompt_layer: "section_implement" },
+    { from: "implementing", event: "gate_passed", to: "implementing", prompt_layer: "section_implement" },
+    { from: "repairing", event: "verify_passed", to: "implementing", prompt_layer: "section_implement" },
+    { from: "repairing", event: "gate_passed", to: "implementing", prompt_layer: "section_implement" },
+    { from: "repairing", event: "verify_failed", to: "repairing", prompt_layer: "repair" },
+    { from: "repairing", event: "replan_requested", to: "planning", prompt_layer: "planning" },
+    { from: "implementing", event: "integration_due", to: "integrating", prompt_layer: "integration" },
+    { from: "integrating", event: "integration_passed", to: "implementing", prompt_layer: "section_implement" },
+    { from: "integrating", event: "integration_failed", to: "repairing", prompt_layer: "repair" },
+    { from: "integrating", event: "all_sections_ready", to: "released", prompt_layer: "integration" },
+    { from: "implementing", event: "all_sections_ready", to: "integrating", prompt_layer: "integration" },
+    { from: "implementing", event: "replan_requested", to: "planning", prompt_layer: "planning" },
+];
+/**
+ * Compute the next app state and the prompt layer the agent should receive.
+ * If no transition matches, the state is preserved and `matched` is false; the
+ * caller should treat that as a no-op (continue the current loop).
+ */
+export function step(current, event) {
+    for (const t of TRANSITIONS) {
+        if (t.from === current && t.event === event.type) {
+            return { next_state: t.to, prompt_layer: t.prompt_layer, matched: true };
+        }
+    }
+    return { next_state: current, prompt_layer: defaultLayerFor(current), matched: false };
+}
+function defaultLayerFor(state) {
+    switch (state) {
+        case "idle":
+        case "planning":
+            return "master_human";
+        case "implementing":
+            return "section_implement";
+        case "repairing":
+            return "repair";
+        case "integrating":
+        case "released":
+            return "integration";
+    }
+}
+export function listTransitions() {
+    return TRANSITIONS;
+}
+//# sourceMappingURL=state_machine.js.map

package/dist/prompt_manager/state_machine.js.map

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

package/dist/prompt_manager/templates.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Prompt Manager — five-layer template library.
+ *
+ * Layers correspond to the lifecycle of multi-section app construction
+ * (see CodeLoop_Development_Plan.md §19):
+ *   1. master_human       — top-level user-facing instruction relayed to the agent
+ *   2. planning           — translate master spec into section graph + checkpoints
+ *   3. section_implement  — per-section build prompt
+ *   4. repair             — issued when verification or gate_check fails
+ *   5. integration        — issued at integration checkpoints to wire sections together
+ *
+ * Each template is plain text with `{{variable}}` placeholders that are filled
+ * from a context object at render time. Missing variables become the literal
+ * empty string (the renderer never throws); callers are expected to validate
+ * required variables via {@link describeTemplate}.
+ */
+export type PromptLayer = "master_human" | "planning" | "section_implement" | "repair" | "integration";
+export interface PromptTemplate {
+    layer: PromptLayer;
+    id: string;
+    description: string;
+    required_vars: readonly string[];
+    body: string;
+}
+export declare const PROMPT_LAYERS: readonly PromptLayer[];
+export declare function listTemplates(): readonly PromptTemplate[];
+export declare function getTemplate(layer: PromptLayer): PromptTemplate;
+export declare function describeTemplate(layer: PromptLayer): {
+    id: string;
+    description: string;
+    required_vars: readonly string[];
+};
+export interface RenderResult {
+    prompt: string;
+    missing_vars: string[];
+}
+/**
+ * Render a template using a context object. Missing variables are recorded in
+ * `missing_vars` and replaced with the empty string. Caller decides whether to
+ * treat missing required variables as an error.
+ */
+export declare function renderTemplate(layer: PromptLayer, context?: Record<string, unknown>): RenderResult;
+//# sourceMappingURL=templates.d.ts.map

package/dist/prompt_manager/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/prompt_manager/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,UAAU,GACV,mBAAmB,GACnB,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAwHD,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAM/C,CAAC;AAEF,wBAAgB,aAAa,IAAI,SAAS,cAAc,EAAE,CAEzD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAM9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAOA;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,YAAY,CAiBd"}

package/dist/prompt_manager/templates.js

@@ -0,0 +1,177 @@
+/**
+ * Prompt Manager — five-layer template library.
+ *
+ * Layers correspond to the lifecycle of multi-section app construction
+ * (see CodeLoop_Development_Plan.md §19):
+ *   1. master_human       — top-level user-facing instruction relayed to the agent
+ *   2. planning           — translate master spec into section graph + checkpoints
+ *   3. section_implement  — per-section build prompt
+ *   4. repair             — issued when verification or gate_check fails
+ *   5. integration        — issued at integration checkpoints to wire sections together
+ *
+ * Each template is plain text with `{{variable}}` placeholders that are filled
+ * from a context object at render time. Missing variables become the literal
+ * empty string (the renderer never throws); callers are expected to validate
+ * required variables via {@link describeTemplate}.
+ */
+const TEMPLATES = {
+    master_human: {
+        layer: "master_human",
+        id: "master_human.v1",
+        description: "Initial framing for the agent when the user issues a one-line application goal. Echoes back the goal, requires a master spec, and forces a planning pass.",
+        required_vars: ["user_goal", "project_name"],
+        body: [
+            "You are working on **{{project_name}}**.",
+            "",
+            "User goal:",
+            "> {{user_goal}}",
+            "",
+            "Before writing any code:",
+            "1. Confirm `docs/specs/_master.md` exists. If it does not, write one that breaks the goal into independently testable sections with explicit dependencies.",
+            "2. Call `codeloop_section_status` to bootstrap the section registry.",
+            "3. Call `codeloop_get_prompt` with `layer=\"planning\"` to produce a build plan, then proceed section by section.",
+            "",
+            "Constraints:",
+            "- Never declare the project complete without a passing `codeloop_gate_check` (confidence ≥ 94%).",
+            "- After every code change, call `codeloop_verify`. If `codeloop_diagnose` returns repair tasks, call `codeloop_get_prompt` with `layer=\"repair\"`.",
+            "- After every {{integration_cadence}} sections, call `codeloop_integration_check`.",
+        ].join("\n"),
+    },
+    planning: {
+        layer: "planning",
+        id: "planning.v1",
+        description: "Translates the master spec into an ordered build plan and per-section acceptance criteria. Output is consumed by section_implement.",
+        required_vars: ["master_spec_path", "section_count"],
+        body: [
+            "Plan a section-by-section build for the spec at `{{master_spec_path}}`.",
+            "There are {{section_count}} sections. For each section, list:",
+            "  - section_id (kebab-case, matches the spec heading)",
+            "  - blocking dependencies (other section_ids that must be `READY` first)",
+            "  - acceptance criteria (testable, max 6 bullets)",
+            "  - integration risk (which earlier sections are most likely to regress)",
+            "",
+            "Order the sections via topological sort. When dependencies tie, prefer the section with the fewest acceptance criteria first to maximise early gate-check signal.",
+            "",
+            "Emit the result as JSON matching this shape:",
+            "```json",
+            "{",
+            "  \"order\": [\"section-id-1\", \"section-id-2\", ...],",
+            "  \"sections\": {",
+            "    \"section-id-1\": { \"deps\": [], \"acceptance\": [...], \"risk\": [...] }",
+            "  },",
+            "  \"integration_checkpoints\": [\"section-id-2\", \"section-id-4\"]",
+            "}",
+            "```",
+        ].join("\n"),
+    },
+    section_implement: {
+        layer: "section_implement",
+        id: "section_implement.v1",
+        description: "Per-section build prompt. Embeds acceptance criteria and forces a verify+gate loop before the section may be marked READY.",
+        required_vars: ["section_id", "section_name", "acceptance_criteria"],
+        body: [
+            "Implement section **{{section_id}} — {{section_name}}**.",
+            "",
+            "Acceptance criteria:",
+            "{{acceptance_criteria}}",
+            "",
+            "Dependencies already READY: {{ready_deps}}",
+            "",
+            "Workflow:",
+            "1. Make the smallest coherent code change that advances at least one acceptance criterion.",
+            "2. Call `codeloop_verify` with `section_id={{section_id}}`.",
+            "3. If verification fails, request the repair prompt (`codeloop_get_prompt` layer=\"repair\"). Do not skip to the next section.",
+            "4. When all acceptance criteria are met and `codeloop_gate_check` passes for this section, call `codeloop_section_status` to mark it READY.",
+            "",
+            "Do not modify files belonging to other sections. If you must, stop and request `layer=\"integration\"` instead.",
+        ].join("\n"),
+    },
+    repair: {
+        layer: "repair",
+        id: "repair.v1",
+        description: "Repair prompt. Used when codeloop_verify or codeloop_gate_check fails. Forces a constrained, deterministic fix loop.",
+        required_vars: ["section_id", "failure_summary", "attempt", "max_attempts"],
+        body: [
+            "Repair attempt {{attempt}}/{{max_attempts}} for section **{{section_id}}**.",
+            "",
+            "Failure summary from `codeloop_diagnose`:",
+            "{{failure_summary}}",
+            "",
+            "Rules:",
+            "1. Address the highest-priority repair task first.",
+            "2. Do not introduce changes outside the failing section's directory unless the diagnose report explicitly says so.",
+            "3. After each fix, re-run `codeloop_verify` for this section only.",
+            "4. If attempt {{attempt}} >= {{max_attempts}}, stop and call `codeloop_replan` to escalate.",
+            "",
+            "Treat any new lint warnings or test regressions in already-READY sections as a hard stop — switch to the integration prompt instead.",
+        ].join("\n"),
+    },
+    integration: {
+        layer: "integration",
+        id: "integration.v1",
+        description: "Integration prompt issued at checkpoints. Coordinates cross-section verification and regression hunting.",
+        required_vars: ["sections_in_scope", "checkpoint_index"],
+        body: [
+            "Integration checkpoint #{{checkpoint_index}}.",
+            "",
+            "Sections in scope: {{sections_in_scope}}",
+            "",
+            "Workflow:",
+            "1. Call `codeloop_integration_check` for the listed sections.",
+            "2. For each regression listed in the result, open the affected section, run `codeloop_get_prompt` with `layer=\"repair\"`, and fix it before continuing.",
+            "3. Capture cross-section screenshots and a short interaction recording with `codeloop_capture_screenshot` and `codeloop_start_recording`/`codeloop_stop_recording`.",
+            "4. Call `codeloop_gate_check` with `scope=\"integration\"`.",
+            "",
+            "Only return to per-section work when integration confidence is ≥ 94%.",
+        ].join("\n"),
+    },
+};
+export const PROMPT_LAYERS = [
+    "master_human",
+    "planning",
+    "section_implement",
+    "repair",
+    "integration",
+];
+export function listTemplates() {
+    return PROMPT_LAYERS.map((layer) => TEMPLATES[layer]);
+}
+export function getTemplate(layer) {
+    const t = TEMPLATES[layer];
+    if (!t) {
+        throw new Error(`Unknown prompt layer: ${layer}`);
+    }
+    return t;
+}
+export function describeTemplate(layer) {
+    const t = getTemplate(layer);
+    return {
+        id: t.id,
+        description: t.description,
+        required_vars: t.required_vars,
+    };
+}
+/**
+ * Render a template using a context object. Missing variables are recorded in
+ * `missing_vars` and replaced with the empty string. Caller decides whether to
+ * treat missing required variables as an error.
+ */
+export function renderTemplate(layer, context = {}) {
+    const tpl = getTemplate(layer);
+    const missing = [];
+    const prompt = tpl.body.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (_m, key) => {
+        const value = context[key];
+        if (value === undefined || value === null || value === "") {
+            if (tpl.required_vars.includes(key)) {
+                missing.push(key);
+            }
+            return "";
+        }
+        if (Array.isArray(value)) {
+            return value.map((v) => `- ${String(v)}`).join("\n");
+        }
+        return String(value);
+    });
+    return { prompt, missing_vars: [...new Set(missing)] };
+}
+//# sourceMappingURL=templates.js.map

package/dist/prompt_manager/templates.js.map

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

package/dist/runners/base.d.ts

@@ -12,7 +12,7 @@ export interface RunnerResult {
 }
 export declare function makeSkippedResult(runnerName: string, reason: string): RunnerResult;
 export declare function checkToolAvailable(command: string): Promise<boolean>;
-export declare function runCommand(cmd: string, args: string[], cwd: string, logPath?: string): Promise<{
+export declare function runCommand(cmd: string, args: string[], cwd: string, logPath?: string, extraEnv?: Record<string, string>): Promise<{
     exit_code: number;
     stdout: string;
     stderr: string;

package/dist/runners/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/runners/base.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,YAAY,CAad;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1E;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAqDrF"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/runners/base.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,YAAY,CAad;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1E;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAqDrF"}

package/dist/runners/base.js

@@ -25,7 +25,7 @@ export async function checkToolAvailable(command) {
         return false;
     }
 }
-export async function runCommand(cmd, args, cwd, logPath) {
+export async function runCommand(cmd, args, cwd, logPath, extraEnv) {
     const start = Date.now();
     return new Promise((resolve) => {
         const quotedArgs = args.map(a => (a.includes(" ") ? `"${a}"` : a));
@@ -33,7 +33,7 @@ export async function runCommand(cmd, args, cwd, logPath) {
             cwd,
             shell: true,
             stdio: ["pipe", "pipe", "pipe"],
-            env: { ...process.env },
+            env: { ...process.env, ...(extraEnv ?? {}) },
         });
         const stdoutChunks = [];
         const stderrChunks = [];

package/dist/runners/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/runners/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAe/B,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,MAAc;IAEd,OAAO;QACL,WAAW,EAAE,UAAU;QACvB,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,CAAC,CAAC;QACb,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAe;IACtD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACpE,OAAO,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,IAAc,EACd,GAAW,EACX,OAAgB;IAEhB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE;YACnC,GAAG;YACH,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;QAEH,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAErE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAE7D,IAAI,OAAO,EAAE,CAAC;gBACZ,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjD,aAAa,CACX,OAAO,EACP,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI;oBAC5B,cAAc,IAAI,IAAI,CAAC,IAAI;oBAC3B,gBAAgB,WAAW,MAAM;oBACjC,mBAAmB,MAAM,IAAI;oBAC7B,mBAAmB,MAAM,IAAI,CAChC,CAAC;YACJ,CAAC;YAED,OAAO,CAAC;gBACN,SAAS,EAAE,IAAI,IAAI,CAAC;gBACpB,MAAM;gBACN,MAAM;gBACN,WAAW;aACZ,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACvC,OAAO,CAAC;gBACN,SAAS,EAAE,GAAG;gBACd,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,oBAAoB,GAAG,EAAE;gBACjC,WAAW;aACZ,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/runners/base.ts"],"names":[],"mappings":"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"}

package/dist/runners/figma_spec_generator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Figma Spec Generator — pulls design tokens (colors, typography, spacing)
+ * from a Figma file's styles and writes them to `docs/specs/` and
+ * `docs/ui_rules.md`. Extends the existing Figma fetcher with token-level
+ * extraction via the Figma REST API v1 `files/:key` endpoint.
+ */
+export interface ColorToken {
+    name: string;
+    hex: string;
+    opacity: number;
+    r: number;
+    g: number;
+    b: number;
+}
+export interface TypographyToken {
+    name: string;
+    family: string;
+    weight: number;
+    size: number;
+    line_height?: number;
+    letter_spacing?: number;
+}
+export interface SpacingToken {
+    name: string;
+    value: number;
+}
+export interface DesignTokens {
+    colors: ColorToken[];
+    typography: TypographyToken[];
+    spacing: SpacingToken[];
+    extracted_at: string;
+    figma_file_key: string;
+}
+/**
+ * Extract design tokens from a Figma file using the REST API.
+ */
+export declare function extractTokensFromFigma(fileKey: string, token: string): Promise<{
+    tokens: DesignTokens;
+    errors: string[];
+}>;
+export declare function writeTokenFiles(cwd: string, tokens: DesignTokens): {
+    specPath: string;
+    rulesPath: string;
+};
+/**
+ * Full pipeline: load Figma config -> extract tokens -> write docs.
+ */
+export declare function generateSpec(cwd: string): Promise<{
+    tokens: DesignTokens;
+    errors: string[];
+    specPath?: string;
+    rulesPath?: string;
+}>;
+//# sourceMappingURL=figma_spec_generator.d.ts.map

package/dist/runners/figma_spec_generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma_spec_generator.d.ts","sourceRoot":"","sources":["../../src/runners/figma_spec_generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAUD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkFrD;AA4ED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAWzC;AA8CD;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B5F"}