@protoboxai/codeloop 0.3.0

package/dist/lib/mcp.js

@@ -0,0 +1,57 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { DONE, findCard, inLane, readCards } from './cards.js';
+import { advanceCard, rejectCard, resolveRole } from './engine.js';
+import { approveFlow } from './flow.js';
+import { buildInbox } from './inbox.js';
+import { loadLane, substitute } from './lane.js';
+import { resolveSpecDir, tickTask } from './spec.js';
+import { capture, inject } from './wiki.js';
+function card(projectDir, id) {
+    const found = findCard(readCards(projectDir).cards, id);
+    const stage = found.stage === DONE ? undefined : loadLane(projectDir, found.lane).stages.find(s => s.id === found.stage);
+    return {
+        ...found,
+        brief: stage && {
+            skill: stage.skill,
+            output: stage.output && substitute(stage.output, found),
+            done: stage.done?.cmd ? substitute(stage.done.cmd, found, { shell: true }) : stage.done?.event,
+            notes: stage.notes ?? [],
+            rejections: found.events.filter(e => e.action === 'reject' && e.stage === stage.id).map(e => e.note),
+        },
+    };
+}
+/** Same engine as the CLI. The role comes from CODELOOP_ROLE in the server's environment, never from a tool argument. */
+export async function serveMcp(projectDir) {
+    const server = new McpServer({ name: 'codeloop', version: '0.2.0' });
+    const id = { id: z.string().describe('Card id, e.g. c-001') };
+    const tool = (name, description, inputSchema, run) => server.registerTool(name, { description, inputSchema }, (async (args) => {
+        try {
+            return { content: [{ type: 'text', text: JSON.stringify(run(args), null, 2) }] };
+        }
+        catch (e) {
+            return { isError: true, content: [{ type: 'text', text: `${e.name}: ${e.message}` }] };
+        }
+    }));
+    tool('inbox', 'Gates waiting on a person, what shipped, and numbers per lane.', {}, () => buildInbox(projectDir));
+    tool('next_up', 'Cards an agent can work now: unfinished and not waiting at a gate, oldest first.', {}, () => readCards(projectDir).cards.filter(c => inLane(c) && !c.gate).sort((a, b) => a.createdAt.localeCompare(b.createdAt)).map(c => card(projectDir, c.id)));
+    tool('get_card', 'A card with its current stage brief: skill, output path, done check, notes, earlier rejections.', id, a => card(projectDir, a.id));
+    tool('advance', "Run the current stage's done check and move the card if it passes.", id, a => {
+        const r = advanceCard(projectDir, a.id);
+        return { outcome: r.outcome, stage: r.card.stage, gate: r.card.gate, awaiting: r.card.awaiting, output: r.output, started: r.started.map(s => s.id) };
+    });
+    tool('approve', 'Approve the gate a card is waiting at, then advance it once. Refused unless the server runs with CODELOOP_ROLE=owner or reviewer.', { ...id, note: z.string().optional() }, a => {
+        const r = approveFlow(projectDir, a.id, resolveRole(), a.note);
+        return { approved: r.gate, stage: (r.advanced?.card ?? r.card).stage, outcome: r.advanced?.outcome };
+    });
+    tool('reject', 'Reject the gate with a note. Refused unless the server runs with CODELOOP_ROLE=owner or reviewer.', { ...id, note: z.string() }, a => rejectCard(projectDir, a.id, resolveRole(), a.note));
+    tool('task_done', 'Tick a task in the card spec folder.', { ...id, task: z.string().describe('Task id, e.g. T003') }, a => {
+        tickTask(projectDir, resolveSpecDir(projectDir, a.id), a.task);
+        return { done: a.task };
+    });
+    tool('wiki_inject', 'Wiki pages whose scope matches these files.', { files: z.array(z.string()) }, a => inject(projectDir, a.files));
+    tool('wiki_capture', 'Write a wiki page; an existing title raises its frequency.', { title: z.string(), scope: z.array(z.string()), body: z.string(), kind: z.enum(['gotcha', 'decision', 'concept']).optional(), card: z.string().optional() }, a => capture(projectDir, a));
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=mcp.js.map

package/dist/lib/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/lib/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,SAAS,IAAI,CAAC,UAAkB,EAAE,EAAU;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC;IACzH,OAAO;QACL,GAAG,KAAK;QACR,KAAK,EAAE,KAAK,IAAI;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;YACvD,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK;YAC9F,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;YACxB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACrG;KACF,CAAC;AACJ,CAAC;AAED,yHAAyH;AACzH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB;IAC/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACrE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;IAE9D,MAAM,IAAI,GAAG,CAA0B,IAAY,EAAE,WAAmB,EAAE,WAAc,EAAE,GAA+C,EAAE,EAAE,CAC3I,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC/F,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAI,CAAW,CAAC,IAAI,KAAM,CAAW,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;QACxH,CAAC;IACH,CAAC,CAAU,CAAC,CAAC;IAEf,IAAI,CAAC,OAAO,EAAE,gEAAgE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAClH,IAAI,CAAC,SAAS,EAAE,kFAAkF,EAAE,EAAE,EAAE,GAAG,EAAE,CAC3G,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzJ,IAAI,CAAC,UAAU,EAAE,iGAAiG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrJ,IAAI,CAAC,SAAS,EAAE,oEAAoE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;QAC5F,MAAM,CAAC,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACxC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,EAAE,mIAAmI,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;QAC/L,MAAM,CAAC,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACvG,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,EAAE,mGAAmG,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3M,IAAI,CAAC,WAAW,EAAE,sCAAsC,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE;QACxH,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,aAAa,EAAE,6CAA6C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACrI,IAAI,CAAC,cAAc,EAAE,4DAA4D,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAE9Q,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/lib/mock.d.ts

@@ -0,0 +1,17 @@
+export declare const MOCKS_DIR = "docs/mocks";
+/** The card's mock, wherever its project and topic folders put it. */
+export declare function findMock(projectDir: string, cardId: string): string | undefined;
+/** Creates the card's mock from the shared template. A mock that exists is never overwritten. */
+export declare function newMock(projectDir: string, ref: string, topic: string): {
+    path: string;
+    created: boolean;
+};
+/** The names under `screens:` in a spec, or 'none' when the spec says the card has nothing to draw. */
+export declare function specScreens(spec: string): string[] | 'none';
+/** Why the card's mock does not pass, one line each. Empty when it passes. */
+export declare function checkMock(projectDir: string, ref: string): string[];
+/** Writes docs/mocks/index.html: projects, then topics, then cards, each newest first. */
+export declare function writeMocksIndex(projectDir: string): {
+    path: string;
+    mocks: number;
+};

package/dist/lib/mock.js

@@ -0,0 +1,137 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'fs';
+import { basename, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { findCard, findCardOrNone, readCards, safeName } from './cards.js';
+import { loadConfig } from './config.js';
+import { resolveSpecDir, slugify } from './spec.js';
+const PACKAGE_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
+const TEMPLATE = 'templates/mock/template.html';
+export const MOCKS_DIR = 'docs/mocks';
+const MARKER = '<!-- codeloop-mock-template: 1 -->';
+const TOKENS = /\/\* codeloop-tokens:start \*\/[\s\S]*?\/\* codeloop-tokens:end \*\//;
+// Hex colours and colour functions. `href="#fff"` is a link to an anchor, and `&#123;` an entity.
+const COLOUR = /(?<![&\w]|href=["'])#(?:[0-9a-fA-F]{8}|[0-9a-fA-F]{6}|[0-9a-fA-F]{3,4})\b|\b(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch)\(/g;
+const template = () => readFileSync(join(PACKAGE_ROOT, TEMPLATE), 'utf-8');
+const escape = (text) => text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+function projectName(projectDir) {
+    return slugify(String(loadConfig(projectDir).project?.name ?? '')) || slugify(basename(projectDir)) || 'project';
+}
+/** The card's mock, wherever its project and topic folders put it. */
+export function findMock(projectDir, cardId) {
+    const root = join(projectDir, MOCKS_DIR);
+    if (!existsSync(root))
+        return undefined;
+    for (const project of dirs(root)) {
+        for (const topic of dirs(join(root, project))) {
+            if (existsSync(join(root, project, topic, `${cardId}.html`)))
+                return `${MOCKS_DIR}/${project}/${topic}/${cardId}.html`;
+        }
+    }
+    return undefined;
+}
+const dirs = (path) => readdirSync(path).filter(d => statSync(join(path, d)).isDirectory()).sort();
+/** Creates the card's mock from the shared template. A mock that exists is never overwritten. */
+export function newMock(projectDir, ref, topic) {
+    const card = findCard(readCards(projectDir).cards, ref);
+    const folder = safeName(topic, 'topic');
+    const existing = findMock(projectDir, card.id);
+    if (existing)
+        return { path: existing, created: false };
+    const project = projectName(projectDir);
+    const path = `${MOCKS_DIR}/${project}/${folder}/${card.id}.html`;
+    const values = { id: card.id, title: escape(card.title), project, topic };
+    mkdirSync(dirname(join(projectDir, path)), { recursive: true });
+    writeFileSync(join(projectDir, path), template().replace(/\{\{(id|title|project|topic)\}\}/g, (_, key) => values[key]));
+    return { path, created: true };
+}
+/** The names under `screens:` in a spec, or 'none' when the spec says the card has nothing to draw. */
+export function specScreens(spec) {
+    const lines = spec.split('\n');
+    const at = lines.findIndex(l => /^screens:/.test(l));
+    if (at < 0)
+        return [];
+    const inline = lines[at].replace(/^screens:/, '').trim();
+    if (inline.toLowerCase() === 'none')
+        return 'none';
+    if (inline)
+        return inline.replace(/^\[|\]$/g, '').split(',').map(s => s.trim()).filter(Boolean);
+    const names = [];
+    for (const line of lines.slice(at + 1)) {
+        const item = /^\s*-\s+(\S.*)$/.exec(line);
+        if (!item) {
+            if (line.trim() === '')
+                continue;
+            break;
+        }
+        names.push(item[1].trim());
+    }
+    return names;
+}
+/** Why the card's mock does not pass, one line each. Empty when it passes. */
+export function checkMock(projectDir, ref) {
+    const card = findCardOrNone(readCards(projectDir).cards, ref);
+    const specDir = resolveSpecDir(projectDir, ref);
+    const specFile = join(projectDir, specDir, 'spec.md');
+    const screens = existsSync(specFile) ? specScreens(readFileSync(specFile, 'utf-8')) : [];
+    if (screens === 'none')
+        return [];
+    // An untouched spec template names nothing, so it cannot pass.
+    if (screens.length === 0)
+        return [`${specDir}/spec.md names no screens under \`screens:\` (write \`screens: none\` for a card with nothing to draw)`];
+    const id = card?.id ?? ref;
+    const path = findMock(projectDir, id);
+    if (!path)
+        return [`no mock for ${id} under ${MOCKS_DIR}; run \`codeloop mock new ${id} --topic <topic>\``];
+    const html = readFileSync(join(projectDir, path), 'utf-8').replace(/\r\n/g, '\n');
+    if (!html.includes(MARKER))
+        return [`${path} does not carry the template marker ${MARKER}`];
+    if (TOKENS.exec(html)?.[0] !== TOKENS.exec(template())[0])
+        return [`${path}: the tokens block differs from ${TEMPLATE}`];
+    const errors = [];
+    const literals = [...new Set(html.replace(TOKENS, '').match(COLOUR) ?? [])];
+    if (literals.length)
+        errors.push(`${path} uses colours outside the tokens block: ${literals.join(', ')}`);
+    for (const screen of screens) {
+        if (!new RegExp(`<section[^>]*\\sdata-screen=["']${screen.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}["']`).test(html)) {
+            errors.push(`${path} has no <section data-screen="${screen}"> for a screen named in the spec`);
+        }
+    }
+    return errors;
+}
+/** Writes docs/mocks/index.html: projects, then topics, then cards, each newest first. */
+export function writeMocksIndex(projectDir) {
+    const root = join(projectDir, MOCKS_DIR);
+    const { cards } = readCards(projectDir);
+    const found = (existsSync(root) ? dirs(root) : []).flatMap(project => dirs(join(root, project)).flatMap(topic => readdirSync(join(root, project, topic)).filter(f => f.endsWith('.html')).map(file => {
+        const full = join(root, project, topic, file);
+        const id = file.replace(/\.html$/, '');
+        const title = cards.find(c => c.id === id)?.title ?? /<title>([^<]*)<\/title>/.exec(readFileSync(full, 'utf-8'))?.[1] ?? id;
+        return { project, topic, id, title, href: `${project}/${topic}/${file}`, at: statSync(full).mtimeMs };
+    })));
+    const newest = (items) => Math.max(...items.map(i => i.at));
+    const group = (items, key) => [...new Set(items.map(i => i[key]))].map(name => ({ name, items: items.filter(i => i[key] === name) })).sort((a, b) => newest(b.items) - newest(a.items));
+    const body = group(found, 'project').map(project => [
+        `<section data-screen="${escape(project.name)}">`,
+        `  <h2>${escape(project.name)}</h2>`,
+        ...group(project.items, 'topic').map(topic => [
+            '  <div class="frame">',
+            `    <strong>${escape(topic.name)}</strong>`,
+            '    <table>',
+            ...topic.items.sort((a, b) => b.at - a.at).map(m => `      <tr><td><a href="${escape(m.href)}">${escape(m.id)}</a></td><td>${escape(m.title)}</td><td class="muted">${new Date(m.at).toISOString().slice(0, 10)}</td></tr>`),
+            '    </table>',
+            '  </div>',
+        ].join('\n')),
+        '</section>',
+    ].join('\n')).join('\n');
+    // The gallery is the same page shell as every mock, with the list where the screens go.
+    const html = template()
+        .replace('<title>{{id}} {{title}}</title>', '<title>Mocks</title>')
+        .replace('<h1>{{title}}</h1>', '<h1>Mocks</h1>')
+        .replace('{{id}} · {{project}} · {{topic}}', `${found.length} ${found.length === 1 ? 'mock' : 'mocks'}, newest first`)
+        .replace(/<main class="screens">[\s\S]*<\/main>/, `<main class="screens">\n${body || '<p class="muted">No mocks yet. `codeloop mock new &lt;card&gt; --topic &lt;topic&gt;` creates one.</p>'}\n</main>`);
+    const path = `${MOCKS_DIR}/index.html`;
+    mkdirSync(root, { recursive: true });
+    writeFileSync(join(projectDir, path), html);
+    return { path, mocks: found.length };
+}
+//# sourceMappingURL=mock.js.map

package/dist/lib/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../src/lib/mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC/F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC/E,MAAM,QAAQ,GAAG,8BAA8B,CAAC;AAChD,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC;AACtC,MAAM,MAAM,GAAG,oCAAoC,CAAC;AACpD,MAAM,MAAM,GAAG,sEAAsE,CAAC;AACtF,kGAAkG;AAClG,MAAM,MAAM,GAAG,wHAAwH,CAAC;AAExI,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEjI,SAAS,WAAW,CAAC,UAAkB;IACrC,OAAO,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,SAAS,CAAC;AACnH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,UAAkB,EAAE,MAAc;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;YAC9C,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;gBAAE,OAAO,GAAG,SAAS,IAAI,OAAO,IAAI,KAAK,IAAI,MAAM,OAAO,CAAC;QACzH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAE3G,iGAAiG;AACjG,MAAM,UAAU,OAAO,CAAC,UAAkB,EAAE,GAAW,EAAE,KAAa;IACpE,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACxD,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,OAAO,IAAI,MAAM,IAAI,IAAI,CAAC,EAAE,OAAO,CAAC;IACjE,MAAM,MAAM,GAA2B,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAClG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,mCAAmC,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChI,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACnD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChG,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,SAAS;YACjC,MAAM;QACR,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,UAAkB,EAAE,GAAW;IACvD,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAClC,+DAA+D;IAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,OAAO,wGAAwG,CAAC,CAAC;IAEtJ,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,GAAG,CAAC;IAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,eAAe,EAAE,UAAU,SAAS,6BAA6B,EAAE,oBAAoB,CAAC,CAAC;IAC5G,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,GAAG,IAAI,uCAAuC,MAAM,EAAE,CAAC,CAAC;IAC5F,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAE,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,GAAG,IAAI,mCAAmC,QAAQ,EAAE,CAAC,CAAC;IAE1H,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,IAAI,QAAQ,CAAC,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,2CAA2C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1G,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,MAAM,CAAC,mCAAmC,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnH,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,iCAAiC,MAAM,mCAAmC,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACzC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CACnE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CACxC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAClF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,yBAAyB,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5H,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,IAAI,KAAK,IAAI,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACxG,CAAC,CAAC,CACH,CACF,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,KAAmB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,CAAgC,KAAmB,EAAE,GAAM,EAAE,EAAE,CAC3E,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAE5J,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,yBAAyB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI;QACjD,SAAS,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO;QACpC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,uBAAuB;YACvB,eAAe,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW;YAC5C,aAAa;YACb,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,0BAA0B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,0BAA0B,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC;YAC5N,cAAc;YACd,UAAU;SACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,YAAY;KACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEzB,wFAAwF;IACxF,MAAM,IAAI,GAAG,QAAQ,EAAE;SACpB,OAAO,CAAC,iCAAiC,EAAE,sBAAsB,CAAC;SAClE,OAAO,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;SAC/C,OAAO,CAAC,kCAAkC,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,gBAAgB,CAAC;SACrH,OAAO,CAAC,uCAAuC,EAAE,2BAA2B,IAAI,IAAI,wGAAwG,WAAW,CAAC,CAAC;IAC5M,MAAM,IAAI,GAAG,GAAG,SAAS,aAAa,CAAC;IACvC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AACvC,CAAC"}

package/dist/lib/pack.d.ts

@@ -0,0 +1,24 @@
+interface PackSkill {
+    skillId: string;
+    title: string;
+    description: string;
+    content: string;
+    toolDeps: string[];
+}
+export declare function skillIdFor(name: string): string;
+export declare function buildPack(projectDir: string, version?: string): {
+    id: string;
+    version: string;
+    'x-source-sha256': string;
+    kind: string;
+    display: {
+        name: string;
+        description: string;
+    };
+    auth: {
+        type: string;
+    }[];
+    availability: string;
+    skills: PackSkill[];
+};
+export {};

package/dist/lib/pack.js

@@ -0,0 +1,77 @@
+import { createHash } from 'crypto';
+import { existsSync, readFileSync } from 'fs';
+import { resolve } from 'path';
+import { RefusalError } from './engine.js';
+import { loadLanes, loadSkillsIndex, SKILLS_INDEX } from './lane.js';
+import { parseFrontmatter } from './skills.js';
+// The Protobox manifest validator requires lower_snake skill ids.
+export function skillIdFor(name) {
+    const id = name.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');
+    if (!/^[a-z][a-z0-9_]*$/.test(id))
+        throw new RefusalError(`skill name "${name}" does not yield a lower_snake skillId`);
+    return id;
+}
+function titleFor(name, title, body) {
+    if (typeof title === 'string' && title.trim())
+        return title.trim();
+    const h1 = /^#\s+(.+?)\s*$/m.exec(body);
+    if (h1)
+        return h1[1].trim();
+    return name.split(/[-_:]/).map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+}
+function guide(lanes) {
+    const lines = ['# Codeloop guide', '', 'Each lane moves a card through its stages in order. A stage runs the named skill and is finished when its done check passes; a gate waits for a person. A gate on a public step is asked first: approve before the stage runs. Other gates are approved after the check passes.', ''];
+    for (const lane of lanes) {
+        lines.push(`## ${lane.id} (v${lane.version})`, '', '| Stage | Skill | Output | Done check | Gate |', '|---|---|---|---|---|');
+        for (const s of lane.stages) {
+            const who = s.skill ? skillIdFor(s.skill) : [s.role ?? ''].flat().join(', ');
+            const gate = s.gate ? `${s.gate.name} (${s.gate.approver}, ${s.gate.outward ? 'public step: approve before the stage runs' : 'approve after the check passes'})` : '';
+            lines.push(`| ${s.id} | ${who} | ${s.output ?? ''} | ${(s.done?.cmd ?? s.done?.event ?? '').replace(/\|/g, '\\|')} | ${gate} |`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function buildPack(projectDir, version = '1.0.0') {
+    const lanes = loadLanes(projectDir);
+    if (lanes.length === 0)
+        throw new RefusalError('no lanes found; nothing to pack');
+    const index = loadSkillsIndex(projectDir);
+    if (!index)
+        throw new RefusalError(`${SKILLS_INDEX} not found; run \`codeloop adopt\` first`);
+    const names = [...new Set(lanes.flatMap(l => l.stages.map(s => s.skill).filter((s) => !!s)))].sort();
+    const missing = names.filter(n => !index.some(e => e.name === n));
+    if (missing.length)
+        throw new RefusalError(`lanes reference skills that are not in ${SKILLS_INDEX}: ${missing.join(', ')}`);
+    const skills = names.map(name => {
+        const found = index.find(e => e.name === name);
+        const file = resolve(projectDir, found.source);
+        if (!existsSync(file))
+            throw new RefusalError(`skill ${name}: source ${found.source} no longer exists; re-run \`codeloop adopt\``);
+        const { data, body } = parseFrontmatter(readFileSync(file, 'utf-8'));
+        const title = titleFor(name, data.title, body);
+        return { skillId: skillIdFor(name), title, description: found.description || title || `${name} skill`, content: body.trim(), toolDeps: [] };
+    });
+    skills.push({
+        skillId: 'codeloop_guide',
+        title: 'Codeloop guide',
+        description: 'Which lane runs which skill at which stage, what each stage must produce, and how it is checked.',
+        content: guide(lanes),
+        toolDeps: [],
+    });
+    const hash = createHash('sha256');
+    for (const s of skills)
+        hash.update(s.skillId).update('\0').update(s.content).update('\0');
+    return {
+        id: 'codeloop',
+        version,
+        'x-source-sha256': hash.digest('hex'),
+        // 'platform' with no platform block is the manifest validator's skills-only case.
+        kind: 'platform',
+        display: { name: 'Codeloop', description: 'Lanes for building, shipping and marketing, with the skills each stage runs.' },
+        auth: [{ type: 'none' }],
+        availability: 'available',
+        skills,
+    };
+}
+//# sourceMappingURL=pack.js.map

package/dist/lib/pack.js.map

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

package/dist/lib/proposals.d.ts

@@ -0,0 +1,48 @@
+import { type Role } from './engine.js';
+export declare const PROPOSALS_DIR = ".codeloop/proposals";
+export declare const LANE_CHANGES = ".codeloop/state/lane-changes.json";
+export interface EvalResult {
+    proposal: string;
+    lane: string;
+    version: number;
+    at: string;
+    laneSha: string;
+    lint: string[];
+    fixtures: {
+        stage: string;
+        fixture: string;
+        expect: string;
+        got: string;
+        ok: boolean;
+    }[];
+    vacuous: string[];
+    replay: string[];
+    replayed: {
+        card: string;
+        stage: string;
+        passed: boolean;
+        accepted: boolean;
+    }[];
+    /** Ways the proposal makes the lane less strict. Each needs a reason under accept_weakening in eval.yaml. */
+    weakening: {
+        change: string;
+        detail: string;
+        accepted: boolean;
+        reason?: string;
+    }[];
+    green: boolean;
+    exitCode: number;
+}
+export declare function propose(projectDir: string, now?: Date): string[];
+export declare function evalProposal(projectDir: string, id: string, now?: Date): EvalResult;
+export declare function promote(projectDir: string, id: string, role: Role, now?: Date): {
+    lane: string;
+    from: number | null;
+    to: number;
+    weakening: EvalResult['weakening'];
+};
+export declare function rollback(projectDir: string, laneId: string, role: Role, now?: Date): {
+    lane: string;
+    from: number;
+    to: number;
+};