@caiqueoak/flow 0.7.0 → 0.8.0

package/dist/domain/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/domain/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AACrE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;AAChD,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAChD,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,KAAK,GACL,aAAa,GACb,SAAS,GACT,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,QAAQ,GACR,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,GAAG,wBAAwB,CAAC;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,GAAG,UAAU,CAAC;CACnC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,IAAI,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,YAAY,CAAC;IAC5B,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,IAAI,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE;QAAE,KAAK,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,MAAM,EAAE;QAAE,SAAS,EAAE,IAAI,MAAM,EAAE,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,IAAI,MAAM,KAAK,MAAM,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC;IACjF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE;QAAE,MAAM,EAAE,cAAc,GAAG,wBAAwB,GAAG,WAAW,CAAA;KAAE,CAAC;CAChF"}

package/dist/domain/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/domain/types.ts"],"names":[],"mappings":""}

package/dist/entry.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=entry.d.ts.map

package/dist/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":""}

package/dist/entry.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+await import('./cli.mjs');
+export {};
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":";AAEA,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC"}

package/dist/shared/cli-io.d.mts

@@ -0,0 +1,15 @@
+export declare class CliError extends Error {
+}
+export declare function fail(message: any, code?: number): void;
+export declare function info(message?: string): void;
+export declare function promptText(message: any, defaultValue?: string): Promise<any>;
+export declare function promptSelect({ title, options, defaultIndex }: {
+    defaultIndex?: number | undefined;
+    options: any;
+    title: any;
+}): Promise<any>;
+export declare function promptMultiSelect({ title, options }: {
+    options: any;
+    title: any;
+}): Promise<any[]>;
+//# sourceMappingURL=cli-io.d.mts.map

package/dist/shared/cli-io.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-io.d.mts","sourceRoot":"","sources":["../../src/shared/cli-io.mjs"],"names":[],"mappings":"AAGA,qBAAa,QAAS,SAAQ,KAAK;CAAG;AACtC,wBAAgB,IAAI,CAAC,OAAO,KAAA,EAAE,IAAI,SAAI,QAIrC;AACD,wBAAgB,IAAI,CAAC,OAAO,SAAK,QAEhC;AAuBD,wBAAsB,UAAU,CAAC,OAAO,KAAA,EAAE,YAAY,SAAK,gBAQ1D;AACD,wBAAsB,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,YAAgB,EAAE;;;;CAAA,gBAkBtE;AACD,wBAAsB,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;;;CAAA,kBAuBzD"}

package/dist/shared/cli-io.mjs

@@ -0,0 +1,83 @@
+import readline from 'node:readline/promises';
+import { stdin as inputStream, stdout as outputStream } from 'node:process';
+export class CliError extends Error {
+}
+export function fail(message, code = 1) {
+    const error = new CliError(message);
+    error.exitCode = code;
+    throw error;
+}
+export function info(message = '') {
+    console.log(message);
+}
+function abortedPromptError() {
+    const error = new Error('Prompt aborted.');
+    error.code = 'ABORT_ERR';
+    return error;
+}
+function question(readlineInterface, message) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (callback, value) => {
+            if (settled)
+                return;
+            settled = true;
+            readlineInterface.removeListener('close', onClose);
+            callback(value);
+        };
+        const onClose = () => finish(reject, abortedPromptError());
+        readlineInterface.once('close', onClose);
+        readlineInterface.question(message).then((answer) => finish(resolve, answer), (error) => finish(reject, error));
+    });
+}
+export async function promptText(message, defaultValue = '') {
+    const rl = readline.createInterface({ input: inputStream, output: outputStream });
+    try {
+        const answer = (await question(rl, `${message}${defaultValue ? ` [${defaultValue}]` : ''}: `)).trim();
+        return answer || defaultValue;
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function promptSelect({ title, options, defaultIndex = 0 }) {
+    info(title);
+    options.forEach((option, index) => info(`  ${index === defaultIndex ? '›' : ' '} ${index + 1}. ${option.label}${option.description ? `\n     ${option.description}` : ''}`));
+    const rl = readline.createInterface({ input: inputStream, output: outputStream });
+    try {
+        while (true) {
+            const answer = (await question(rl, `Selection [${defaultIndex + 1}]: `)).trim();
+            const index = answer ? Number.parseInt(answer, 10) - 1 : defaultIndex;
+            if (Number.isInteger(index) && index >= 0 && index < options.length)
+                return options[index].value;
+            info('Choose a valid number.');
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function promptMultiSelect({ title, options }) {
+    info(title);
+    options.forEach((option, index) => info(`  [ ] ${index + 1}. ${option.label}`));
+    info('  (Select multiple with comma-separated numbers, e.g. 1,2)');
+    const rl = readline.createInterface({ input: inputStream, output: outputStream });
+    try {
+        while (true) {
+            const answer = (await question(rl, 'Selection: ')).trim();
+            const indices = [
+                ...new Set(answer
+                    .split(',')
+                    .map((value) => Number.parseInt(value.trim(), 10))
+                    .filter(Number.isInteger))
+            ];
+            if (indices.length && indices.every((index) => index >= 1 && index <= options.length))
+                return indices.map((index) => options[index - 1].value);
+            info('Choose one or more valid numbers.');
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=cli-io.mjs.map

package/dist/shared/cli-io.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-io.mjs","sourceRoot":"","sources":["../../src/shared/cli-io.mjs"],"names":[],"mappings":"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"}

package/dist/shared/profiles.d.mts

@@ -0,0 +1,17 @@
+export declare function parseProfileFrontmatter(text: any): any;
+export declare const READABILITY_FIRST_PROFILE: any;
+export declare const ENGINEERING_PROFILES: {
+    [READABILITY_FIRST_PROFILE.id]: any;
+    'readability-first': any;
+};
+export declare const BROWNFIELD_POLICIES: {
+    improve: {
+        label: string;
+        description: string;
+    };
+    preserve: {
+        label: string;
+        description: string;
+    };
+};
+//# sourceMappingURL=profiles.d.mts.map

package/dist/shared/profiles.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.mts","sourceRoot":"","sources":["../../src/shared/profiles.mjs"],"names":[],"mappings":"AAMA,wBAAgB,uBAAuB,CAAC,IAAI,KAAA,OAI3C;AACD,eAAO,MAAM,yBAAyB,KAAgC,CAAC;AACvE,eAAO,MAAM,oBAAoB;IAE/B,CAAC,yBAAyB,CAAC,EAAE,CAAC,MAA2B;;CAC1D,CAAC;AACF,eAAO,MAAM,mBAAmB;IAC9B,OAAO;QACL,KAAK;QACL,WAAW;;IAGb,QAAQ;QACN,KAAK;QACL,WAAW;;CAEd,CAAC"}

package/dist/shared/profiles.mjs

@@ -0,0 +1,25 @@
+import fs from 'node:fs';
+import { parse } from 'yaml';
+const text = fs.readFileSync(new URL('../../skills/flow/engineering/profiles/readability-first.md', import.meta.url), 'utf8');
+export function parseProfileFrontmatter(text) {
+    const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
+    if (!match)
+        throw new Error('Missing YAML frontmatter in Flow profile.');
+    return parse(match[1]);
+}
+export const READABILITY_FIRST_PROFILE = parseProfileFrontmatter(text);
+export const ENGINEERING_PROFILES = {
+    'readability-first': READABILITY_FIRST_PROFILE,
+    [READABILITY_FIRST_PROFILE.id]: READABILITY_FIRST_PROFILE
+};
+export const BROWNFIELD_POLICIES = {
+    improve: {
+        label: 'Improve existing structure — Recommended',
+        description: 'Preserve behavior and external contracts; recommend clearer structure where justified. Does not authorize refactoring.'
+    },
+    preserve: {
+        label: 'Keep existing structure',
+        description: 'Retain consistent conventions unless a concrete problem warrants an approved change.'
+    }
+};
+//# sourceMappingURL=profiles.mjs.map

package/dist/shared/profiles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.mjs","sourceRoot":"","sources":["../../src/shared/profiles.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAC1B,IAAI,GAAG,CAAC,6DAA6D,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EACvF,MAAM,CACP,CAAC;AACF,MAAM,UAAU,uBAAuB,CAAC,IAAI;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACnE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC;AACD,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,mBAAmB,EAAE,yBAAyB;IAC9C,CAAC,yBAAyB,CAAC,EAAE,CAAC,EAAE,yBAAyB;CAC1D,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,OAAO,EAAE;QACP,KAAK,EAAE,0CAA0C;QACjD,WAAW,EACT,wHAAwH;KAC3H;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,sFAAsF;KACpG;CACF,CAAC"}

package/dist/shared/project-config.d.mts

@@ -0,0 +1,21 @@
+export declare function configPath(root: any): any;
+export declare function defaultConfig(flowVersion?: string): {
+    schema_version: number;
+    flow_version: string;
+    runtimes: never[];
+    engineering: {
+        profile: string;
+        existing_code_policy: string;
+    };
+};
+export declare function readConfig(root: any): {
+    schema_version: number;
+    flow_version: string;
+    runtimes: never[];
+    engineering: {
+        profile: string;
+        existing_code_policy: string;
+    };
+} | null;
+export declare function writeConfig(root: any, config: any): void;
+//# sourceMappingURL=project-config.d.mts.map

package/dist/shared/project-config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.mts","sourceRoot":"","sources":["../../src/shared/project-config.mjs"],"names":[],"mappings":"AAKA,wBAAgB,UAAU,CAAC,IAAI,KAAA,OAE9B;AAED,wBAAgB,aAAa,CAAC,WAAW,SAAU;;;;;QAKhC,OAAO;QAA8B,oBAAoB;;EAE3E;AAED,wBAAgB,UAAU,CAAC,IAAI,KAAA;;;;;QAJZ,OAAO;QAA8B,oBAAoB;;SAc3E;AAED,wBAAgB,WAAW,CAAC,IAAI,KAAA,EAAE,MAAM,KAAA,QAYvC"}

package/dist/shared/project-config.mjs

@@ -0,0 +1,41 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { parse, stringify } from 'yaml';
+import { FLOW_SCHEMA_VERSION } from '../domain/contracts.mjs';
+export function configPath(root) {
+    return path.join(root, '_flow', 'config.yaml');
+}
+export function defaultConfig(flowVersion = '0.6.0') {
+    return {
+        schema_version: FLOW_SCHEMA_VERSION,
+        flow_version: flowVersion,
+        runtimes: [],
+        engineering: { profile: 'flow/readability-first@1', existing_code_policy: 'not_applicable' }
+    };
+}
+export function readConfig(root) {
+    const file = configPath(root);
+    if (!fs.existsSync(file))
+        return null;
+    const raw = parse(fs.readFileSync(file, 'utf8')) ?? {};
+    const config = defaultConfig();
+    config.schema_version = raw.schema_version ?? 1;
+    config.flow_version = raw.flow_version ?? null;
+    config.runtimes = Array.isArray(raw.runtimes) ? raw.runtimes : [];
+    config.engineering = { ...config.engineering, ...(raw.engineering ?? {}) };
+    return config;
+}
+export function writeConfig(root, config) {
+    const normalized = {
+        schema_version: FLOW_SCHEMA_VERSION,
+        flow_version: config.flow_version ?? defaultConfig().flow_version,
+        runtimes: config.runtimes ?? [],
+        engineering: {
+            profile: config.engineering?.profile ?? defaultConfig().engineering.profile,
+            existing_code_policy: config.engineering?.existing_code_policy ?? 'not_applicable'
+        }
+    };
+    fs.mkdirSync(path.join(root, '_flow'), { recursive: true });
+    fs.writeFileSync(configPath(root), stringify(normalized, { lineWidth: 0 }), 'utf8');
+}
+//# sourceMappingURL=project-config.mjs.map

package/dist/shared/project-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.mjs","sourceRoot":"","sources":["../../src/shared/project-config.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,UAAU,UAAU,CAAC,IAAI;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAW,GAAG,OAAO;IACjD,OAAO;QACL,cAAc,EAAE,mBAAmB;QACnC,YAAY,EAAE,WAAW;QACzB,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,gBAAgB,EAAE;KAC7F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAI;IAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC;IAC/C,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,CAAC,WAAW,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAI,EAAE,MAAM;IACtC,MAAM,UAAU,GAAG;QACjB,cAAc,EAAE,mBAAmB;QACnC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,aAAa,EAAE,CAAC,YAAY;QACjE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,WAAW,EAAE;YACX,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,IAAI,aAAa,EAAE,CAAC,WAAW,CAAC,OAAO;YAC3E,oBAAoB,EAAE,MAAM,CAAC,WAAW,EAAE,oBAAoB,IAAI,gBAAgB;SACnF;KACF,CAAC;IACF,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AACtF,CAAC"}

package/dist/shared/project-path.d.mts

@@ -0,0 +1,3 @@
+export declare function valueAfter(args: any, name: any): any;
+export declare function projectRoot(args: any): any;
+//# sourceMappingURL=project-path.d.mts.map

package/dist/shared/project-path.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-path.d.mts","sourceRoot":"","sources":["../../src/shared/project-path.mjs"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,IAAI,KAAA,EAAE,IAAI,KAAA,OAGpC;AAED,wBAAgB,WAAW,CAAC,IAAI,KAAA,OAE/B"}

package/dist/shared/project-path.mjs

@@ -0,0 +1,9 @@
+import path from 'node:path';
+export function valueAfter(args, name) {
+    const index = args.indexOf(name);
+    return index >= 0 ? args[index + 1] : undefined;
+}
+export function projectRoot(args) {
+    return path.resolve(valueAfter(args, '--path') || process.cwd());
+}
+//# sourceMappingURL=project-path.mjs.map

package/dist/shared/project-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-path.mjs","sourceRoot":"","sources":["../../src/shared/project-path.mjs"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,UAAU,CAAC,IAAI,EAAE,IAAI;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAI;IAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/shared/skill-installer.d.mts

@@ -0,0 +1,2 @@
+export declare function installRuntimeSkill(root: any, runtime: any, packageRoot: any): any;
+//# sourceMappingURL=skill-installer.d.mts.map

package/dist/shared/skill-installer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-installer.d.mts","sourceRoot":"","sources":["../../src/shared/skill-installer.mjs"],"names":[],"mappings":"AAaA,wBAAgB,mBAAmB,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA,EAAE,WAAW,KAAA,OAoB7D"}

package/dist/shared/skill-installer.mjs

@@ -0,0 +1,33 @@
+import fs from 'node:fs';
+import path from 'node:path';
+function copyDirectory(source, target) {
+    fs.mkdirSync(target, { recursive: true });
+    for (const entry of fs.readdirSync(source, { withFileTypes: true })) {
+        const sourcePath = path.join(source, entry.name);
+        const targetPath = path.join(target, entry.name);
+        if (entry.isDirectory())
+            copyDirectory(sourcePath, targetPath);
+        else
+            fs.copyFileSync(sourcePath, targetPath);
+    }
+}
+export function installRuntimeSkill(root, runtime, packageRoot) {
+    if (typeof runtime.skills_path !== 'string' ||
+        !runtime.skills_path ||
+        path.isAbsolute(runtime.skills_path) ||
+        runtime.skills_path.split(/[\\/]/).includes('..'))
+        throw new Error('Runtime skills_path must remain project-local.');
+    const target = path.join(root, runtime.skills_path, 'flow');
+    let ancestor = root;
+    for (const segment of path.relative(root, target).split(path.sep)) {
+        ancestor = path.join(ancestor, segment);
+        if (fs.existsSync(ancestor) && fs.lstatSync(ancestor).isSymbolicLink())
+            throw new Error('Refusing a symlinked runtime path.');
+    }
+    if (fs.existsSync(target) && fs.lstatSync(target).isSymbolicLink())
+        throw new Error('Refusing to overwrite a symlinked skill.');
+    fs.rmSync(target, { recursive: true, force: true });
+    copyDirectory(path.join(packageRoot, 'skills', 'flow'), target);
+    return target;
+}
+//# sourceMappingURL=skill-installer.mjs.map

package/dist/shared/skill-installer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-installer.mjs","sourceRoot":"","sources":["../../src/shared/skill-installer.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,aAAa,CAAC,MAAM,EAAE,MAAM;IACnC,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;;YAC1D,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW;IAC5D,IACE,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QACvC,CAAC,OAAO,CAAC,WAAW;QACpB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC;QACpC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAEjD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC5D,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE;YACpE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,cAAc,EAAE;QAChE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,29 +1,37 @@
 {
   "name": "@caiqueoak/flow",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Readability-first, agent-agnostic software development workflow for coding agents.",
   "type": "module",
   "scripts": {
-    "test": "node --test",
+    "clean": "node scripts/clean.mjs",
+    "build": "npm run clean && tsc && node dist/entry.js schemas",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test test/*.test.mjs",
     "lint": "eslint .",
-    "format": "prettier --write src test skills package.json package-lock.json README.md eslint.config.js prettier.config.mjs",
-    "format:check": "prettier --check src test skills package.json package-lock.json README.md eslint.config.js prettier.config.mjs",
-    "pack:check": "npm pack --dry-run"
+    "format": "prettier --write src test scripts skills package.json package-lock.json README.md eslint.config.js prettier.config.mjs tsconfig.json",
+    "format:check": "prettier --check src test scripts skills package.json package-lock.json README.md eslint.config.js prettier.config.mjs tsconfig.json",
+    "pack:check": "npm run build && npm pack --dry-run",
+    "test:package": "node scripts/test-package.mjs",
+    "prepack": "npm run build"
   },
   "bin": {
-    "flow": "./src/cli.mjs"
+    "flow": "./dist/entry.js"
   },
   "dependencies": {
     "yaml": "^2.9.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.36.0",
+    "@types/node": "^22.18.6",
     "eslint": "^9.36.0",
     "globals": "^16.4.0",
-    "prettier": "^3.6.2"
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2"
   },
   "files": [
-    "src",
+    "dist",
+    "schemas",
     "skills",
     "README.md",
     "LICENSE"

package/schemas/backlog.schema.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flow.local/schemas/backlog.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "work_items"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 4
+    },
+    "work_items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "folder",
+          "kind",
+          "title",
+          "state",
+          "priority",
+          "spec_maturity",
+          "depends_on",
+          "blockers"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^W\\d{3,}$",
+            "description": "Permanent work-item identifier."
+          },
+          "folder": {
+            "type": "string",
+            "pattern": "^W\\d{3,}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "kind": {
+            "enum": [
+              "feature",
+              "technical",
+              "maintenance"
+            ]
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "state": {
+            "enum": [
+              "outlined",
+              "blocked",
+              "eligible",
+              "in_progress",
+              "review",
+              "completed"
+            ]
+          },
+          "priority": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "spec_maturity": {
+            "enum": [
+              "outlined",
+              "ready"
+            ]
+          },
+          "depends_on": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "pattern": "^W\\d{3,}$"
+            }
+          },
+          "blockers": {
+            "type": "array"
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/config.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flow.local/schemas/config.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "flow_version",
+    "runtimes",
+    "engineering"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 4
+    },
+    "flow_version": {
+      "type": "string"
+    },
+    "runtimes": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    },
+    "engineering": {
+      "type": "object"
+    }
+  }
+}

package/schemas/gates.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flow.local/schemas/gates.schema.json",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "gates"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 2
+    },
+    "gates": {
+      "type": "array"
+    }
+  }
+}

package/schemas/review.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flow.local/schemas/review.schema.json",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "work_item",
+    "status"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "work_item": {
+      "type": "string",
+      "pattern": "^W\\d{3,}$"
+    },
+    "status": {
+      "enum": [
+        "pending",
+        "approved"
+      ]
+    },
+    "reviewed_at": {
+      "type": "string"
+    }
+  }
+}

package/schemas/tasks.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flow.local/schemas/tasks.schema.json",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "work_item",
+    "tasks"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 3
+    },
+    "work_item": {
+      "type": "string",
+      "pattern": "^W\\d{3,}$"
+    },
+    "tasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "title",
+          "state",
+          "depends_on"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^T\\d{3,}$"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "state": {
+            "enum": [
+              "pending",
+              "in_progress",
+              "completed"
+            ]
+          },
+          "depends_on": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "pattern": "^T\\d{3,}$"
+            }
+          },
+          "provenance": {
+            "enum": [
+              "legacy_migration"
+            ]
+          },
+          "legacy_commit": {
+            "type": "string",
+            "description": "Read-only provenance for migrated completed tasks."
+          }
+        }
+      }
+    }
+  }
+}