@caiqueoak/flow 0.7.0 → 0.8.0

package/dist/cli/command-registry.mjs

@@ -0,0 +1,230 @@
+const common = [{ name: '--path', value: '<project>', description: 'Project root (default: current directory).' }];
+export const COMMANDS = Object.freeze([
+    {
+        name: 'init',
+        description: 'Initialize Flow or refresh runtime integrations.',
+        usage: 'flow init [options]',
+        flags: [
+            ...common,
+            { name: '--runtime', value: '<list>' },
+            { name: '--profile', value: '<id>', default: 'readability-first' },
+            { name: '--existing-code', value: '<policy>', values: ['improve', 'preserve'] }
+        ],
+        effects: 'Writes config and runtime skills.',
+        when: 'Once per project and after an explicit package update.',
+        load: () => import('../commands/init.mjs'),
+        run: 'runInit'
+    },
+    {
+        name: 'doctor',
+        description: 'Diagnose versions, artifacts, schemas and integrations without writing.',
+        usage: 'flow doctor [--quick] [--json]',
+        flags: [...common, { name: '--quick' }, { name: '--json' }],
+        effects: 'Read-only.',
+        when: 'At every /flow start with --quick --json, or before migration.',
+        load: () => import('../commands/doctor.mjs'),
+        run: 'runDoctor'
+    },
+    {
+        name: 'migrate',
+        description: 'Plan or apply deterministic, recoverable structural migrations.',
+        usage: 'flow migrate --plan|--apply [--json]',
+        flags: [...common, { name: '--plan' }, { name: '--apply' }, { name: '--json' }],
+        effects: '--plan is read-only; --apply uses validated staging and a recoverable backup.',
+        when: 'After doctor reports an artifact version mismatch.',
+        load: () => import('../commands/migrate.mjs'),
+        run: 'runMigrate'
+    },
+    {
+        name: 'status',
+        description: 'Show persisted progress and derived eligibility/blocking.',
+        usage: 'flow status [--json]',
+        flags: [...common, { name: '--json' }],
+        effects: 'Read-only.',
+        when: 'To inspect progress.',
+        load: () => import('../commands/status.mjs'),
+        run: 'runStatus'
+    },
+    {
+        name: 'validate',
+        description: 'Run fast structural validation; gates are opt-in.',
+        usage: 'flow validate [--work-item W###] [--gates] [--json]',
+        flags: [
+            ...common,
+            { name: '--work-item', value: '<W###>' },
+            { name: '--gates' },
+            { name: '--pre-commit', value: '<W###-T###>' },
+            { name: '--skip-trace' },
+            { name: '--json' }
+        ],
+        effects: 'Read-only; --gates may execute configured processes.',
+        when: 'After structured changes and before commits.',
+        load: () => import('../commands/validate.mjs'),
+        run: 'runValidate'
+    },
+    {
+        name: 'route',
+        description: 'Resolve the next legal workflow step and safe validation scope.',
+        usage: 'flow route [--json]',
+        flags: [...common, { name: '--json' }],
+        effects: 'Read-only.',
+        when: 'After doctor and every completed workflow step.',
+        load: () => import('../commands/route.mjs'),
+        run: 'runRoute'
+    },
+    {
+        name: 'sync',
+        description: 'Materialize disposable projections from canonical work-items.',
+        usage: 'flow sync',
+        flags: common,
+        effects: 'Reads only canonical work-items; writes _flow/generated/ only.',
+        when: 'After canonical work-item changes.',
+        load: () => import('../commands/sync.mjs'),
+        run: 'runSync'
+    },
+    {
+        name: 'trace',
+        description: 'Resolve a permanent task ID against reachable Git history.',
+        usage: 'flow trace W###[-T###] [--json]',
+        arguments: [{ name: 'identity', required: true, description: 'Task W###-T### or aggregate work-item W###.' }],
+        flags: [...common, { name: '--json' }],
+        effects: 'Read-only Git inspection.',
+        when: 'After task completion and during review.',
+        load: () => import('../commands/trace.mjs'),
+        run: 'runTrace'
+    },
+    {
+        name: 'gates',
+        description: 'List or selectively run deterministic project gates.',
+        usage: 'flow gates list|run [filters]',
+        arguments: [{ name: 'action', required: true }],
+        flags: [
+            ...common,
+            { name: '--id', value: '<gate-id>' },
+            { name: '--task', value: '<W###-T###>' },
+            { name: '--work-item', value: '<W###>' },
+            { name: '--stage', value: '<stage>', values: ['task', 'work-item-review', 'full'] },
+            { name: '--all' },
+            { name: '--json' }
+        ],
+        effects: 'list is read-only; run executes selected commands.',
+        when: 'For the smallest safe verification scope.',
+        load: () => import('../commands/gates.mjs'),
+        run: 'runGates'
+    },
+    {
+        name: 'work-item',
+        description: 'Create or deterministically update backlog work-items.',
+        usage: 'flow work-item <create|set|priority|dependencies|blocker-add|blocker-resolve|promote|review-complete> ...',
+        arguments: [{ name: 'operation', required: true }],
+        flags: [
+            ...common,
+            { name: '--title', value: '<text>' },
+            { name: '--kind', value: '<kind>', values: ['feature', 'technical', 'maintenance'] },
+            { name: '--priority', value: '<integer>' },
+            { name: '--depends-on', value: '<W###,...>' },
+            { name: '--id', value: '<blocker-id>' },
+            { name: '--type', value: '<type>', values: ['external_action', 'consequential_decision'] },
+            { name: '--description', value: '<text>' },
+            { name: '--domain', value: '<domain>' }
+        ],
+        effects: 'Writes only artifacts in the target work-item folder.',
+        when: 'For deterministic backlog mutations.',
+        load: () => import('../commands/operations.mjs'),
+        run: 'runWorkItem'
+    },
+    {
+        name: 'task',
+        description: 'Create, update, start or commit tasks.',
+        usage: 'flow task <create|set|start|commit> W###[-T###] [options]',
+        arguments: [{ name: 'operation', required: true }],
+        flags: [
+            ...common,
+            { name: '--title', value: '<text>' },
+            { name: '--depends-on', value: '<T###,...>' },
+            { name: '--message', value: '<objective commit title>' },
+            { name: '--files', value: '<path,...>' }
+        ],
+        effects: 'Task commit creates the one canonical implementation commit.',
+        when: 'Only after spec maturity is ready.',
+        load: () => import('../commands/operations.mjs'),
+        run: 'runTask'
+    },
+    {
+        name: 'approval',
+        description: 'Persist an explicit human approval for a document revision.',
+        usage: 'flow approval record <path> [--at <ISO timestamp>]',
+        arguments: [{ name: 'operation', required: true }],
+        flags: [...common, { name: '--at', value: '<timestamp>' }],
+        effects: 'Updates approved frontmatter.',
+        when: 'Only after explicit approval of the exact document.',
+        load: () => import('../commands/operations.mjs'),
+        run: 'runApproval'
+    },
+    {
+        name: 'scope',
+        description: 'Validate the staged scope for one task before its implementation commit.',
+        usage: 'flow scope validate W###-T### --files <path,...> [--json]',
+        arguments: [{ name: 'operation', required: true }],
+        flags: [...common, { name: '--files', value: '<path,...>' }, { name: '--json' }],
+        effects: 'Read-only staged Git inspection and structural validation.',
+        when: 'Immediately before a task implementation commit.',
+        load: () => import('../commands/operations.mjs'),
+        run: 'runScope'
+    },
+    {
+        name: 'schemas',
+        description: 'Generate JSON Schemas from central contracts.',
+        usage: 'flow schemas',
+        flags: [],
+        effects: 'Writes package schemas.',
+        when: 'Build/release.',
+        load: () => import('../commands/schemas.mjs'),
+        run: 'runSchemas',
+        hidden: true
+    }
+]);
+export const commandByName = (name) => COMMANDS.find((command) => command.name === name);
+export function renderGlobalHelp(version) {
+    const rows = COMMANDS.filter((command) => !command.hidden).map((command) => `  ${command.name.padEnd(11)} ${command.description}`);
+    return `Flow ${version}\n\nUsage: npx --no-install flow <command> [options]\nEngineering baseline: Readability First.\n\nGlobal parameters:\n  --help, -h       Show help.\n  --version, -v    Show package version.\n  --path <project> Select project root (default: current directory).\n\nCommands:\n${rows.join('\n')}\n\nRun flow <command> --help for syntax, values, effects and usage guidance.`;
+}
+export function renderCommandHelp(command) {
+    const argumentsText = command.arguments?.length
+        ? command.arguments
+            .map((argument) => `  ${argument.name}${argument.required ? ' (required)' : ''} — ${argument.description ?? 'Command argument.'}`)
+            .join('\n')
+        : '  (none)';
+    const flags = command.flags?.length
+        ? command.flags
+            .map((flag) => `  ${flag.name}${flag.value ? ` ${flag.value}` : ''}${flag.values ? ` (${flag.values.join('|')})` : ''}${flag.default ? ` [default: ${flag.default}]` : ''} — ${flag.description ?? 'Command option.'}`)
+            .join('\n')
+        : '  (none)';
+    return `${command.description}\n\nSyntax:\n  ${command.usage}\n\nArguments:\n${argumentsText}\n\nOptions:\n${flags}\n\nEffects:\n  ${command.effects}\n\nUse when:\n  ${command.when}`;
+}
+export function validateCommandArguments(command, args) {
+    const allowed = new Map((command.flags ?? []).map((flag) => [flag.name, flag]));
+    const positional = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index];
+        if (!value.startsWith('-')) {
+            positional.push(value);
+            continue;
+        }
+        const flag = allowed.get(value);
+        if (!flag)
+            throw new Error(`unknown option '${value}' for flow ${command.name}.`);
+        if (flag.value) {
+            const next = args[++index];
+            if (!next || next.startsWith('-'))
+                throw new Error(`${value} requires ${flag.value}.`);
+            if (flag.values && !flag.values.includes(next))
+                throw new Error(`${value} must be one of: ${flag.values.join(', ')}.`);
+        }
+    }
+    if (command.name === 'migrate' && args.includes('--plan') === args.includes('--apply'))
+        throw new Error('flow migrate requires exactly one of --plan or --apply.');
+    if (command.arguments?.some((argument) => argument.required) && !positional.length)
+        throw new Error(`flow ${command.name} requires ${command.arguments[0].name}.`);
+}
+//# sourceMappingURL=command-registry.mjs.map

package/dist/cli/command-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.mjs","sourceRoot":"","sources":["../../src/cli/command-registry.mjs"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC,CAAC;AAEnH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,qBAAqB;QAC5B,KAAK,EAAE;YACL,GAAG,MAAM;YACT,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE;YACtC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE;YAClE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE;SAChF;QACD,OAAO,EAAE,mCAAmC;QAC5C,IAAI,EAAE,wDAAwD;QAC9D,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;QAC1C,GAAG,EAAE,SAAS;KACf;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,yEAAyE;QACtF,KAAK,EAAE,gCAAgC;QACvC,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3D,OAAO,EAAE,YAAY;QACrB,IAAI,EAAE,gEAAgE;QACtE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC;QAC5C,GAAG,EAAE,WAAW;KACjB;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,iEAAiE;QAC9E,KAAK,EAAE,sCAAsC;QAC7C,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC/E,OAAO,EAAE,+EAA+E;QACxF,IAAI,EAAE,oDAAoD;QAC1D,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC;QAC7C,GAAG,EAAE,YAAY;KAClB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,2DAA2D;QACxE,KAAK,EAAE,sBAAsB;QAC7B,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,YAAY;QACrB,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC;QAC5C,GAAG,EAAE,WAAW;KACjB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,mDAAmD;QAChE,KAAK,EAAE,qDAAqD;QAC5D,KAAK,EAAE;YACL,GAAG,MAAM;YACT,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE;YACxC,EAAE,IAAI,EAAE,SAAS,EAAE;YACnB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE;YAC9C,EAAE,IAAI,EAAE,cAAc,EAAE;YACxB,EAAE,IAAI,EAAE,QAAQ,EAAE;SACnB;QACD,OAAO,EAAE,sDAAsD;QAC/D,IAAI,EAAE,8CAA8C;QACpD,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,0BAA0B,CAAC;QAC9C,GAAG,EAAE,aAAa;KACnB;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,iEAAiE;QAC9E,KAAK,EAAE,qBAAqB;QAC5B,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,YAAY;QACrB,IAAI,EAAE,iDAAiD;QACvD,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;QAC3C,GAAG,EAAE,UAAU;KAChB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,+DAA+D;QAC5E,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,gEAAgE;QACzE,IAAI,EAAE,oCAAoC;QAC1C,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;QAC1C,GAAG,EAAE,SAAS;KACf;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,4DAA4D;QACzE,KAAK,EAAE,iCAAiC;QACxC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC;QAC7G,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,2BAA2B;QACpC,IAAI,EAAE,0CAA0C;QAChD,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;QAC3C,GAAG,EAAE,UAAU;KAChB;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,sDAAsD;QACnE,KAAK,EAAE,+BAA+B;QACtC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC/C,KAAK,EAAE;YACL,GAAG,MAAM;YACT,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE;YACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE;YACxC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE;YACxC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE;YACnF,EAAE,IAAI,EAAE,OAAO,EAAE;YACjB,EAAE,IAAI,EAAE,QAAQ,EAAE;SACnB;QACD,OAAO,EAAE,oDAAoD;QAC7D,IAAI,EAAE,2CAA2C;QACjD,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;QAC3C,GAAG,EAAE,UAAU;KAChB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,wDAAwD;QACrE,KAAK,EAAE,2GAA2G;QAClH,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClD,KAAK,EAAE;YACL,GAAG,MAAM;YACT,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE;YACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE;YACpF,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE;YAC1C,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE;YAC7C,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE;YACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,iBAAiB,EAAE,wBAAwB,CAAC,EAAE;YAC1F,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE;YAC1C,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;SACxC;QACD,OAAO,EAAE,uDAAuD;QAChE,IAAI,EAAE,sCAAsC;QAC5C,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC;QAChD,GAAG,EAAE,aAAa;KACnB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,wCAAwC;QACrD,KAAK,EAAE,2DAA2D;QAClE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClD,KAAK,EAAE;YACL,GAAG,MAAM;YACT,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE;YACpC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE;YAC7C,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,0BAA0B,EAAE;YACxD,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE;SACzC;QACD,OAAO,EAAE,8DAA8D;QACvE,IAAI,EAAE,oCAAoC;QAC1C,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC;QAChD,GAAG,EAAE,SAAS;KACf;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,6DAA6D;QAC1E,KAAK,EAAE,oDAAoD;QAC3D,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClD,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAC1D,OAAO,EAAE,+BAA+B;QACxC,IAAI,EAAE,qDAAqD;QAC3D,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC;QAChD,GAAG,EAAE,aAAa;KACnB;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0EAA0E;QACvF,KAAK,EAAE,2DAA2D;QAClE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClD,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAChF,OAAO,EAAE,4DAA4D;QACrE,IAAI,EAAE,kDAAkD;QACxD,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC;QAChD,GAAG,EAAE,UAAU;KAChB;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,yBAAyB;QAClC,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC;QAC7C,GAAG,EAAE,YAAY;QACjB,MAAM,EAAE,IAAI;KACb;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACzF,MAAM,UAAU,gBAAgB,CAAC,OAAO;IACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAC5D,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CACnE,CAAC;IACF,OAAO,QAAQ,OAAO,qRAAqR,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,+EAA+E,CAAC;AAC5Y,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,OAAO;IACvC,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,MAAM;QAC7C,CAAC,CAAC,OAAO,CAAC,SAAS;aACd,GAAG,CACF,CAAC,QAAQ,EAAE,EAAE,CACX,KAAK,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,QAAQ,CAAC,WAAW,IAAI,mBAAmB,EAAE,CACjH;aACA,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,UAAU,CAAC;IACf,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM;QACjC,CAAC,CAAC,OAAO,CAAC,KAAK;aACV,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CACP,KAAK,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,WAAW,IAAI,iBAAiB,EAAE,CAC1M;aACA,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,UAAU,CAAC;IACf,OAAO,GAAG,OAAO,CAAC,WAAW,kBAAkB,OAAO,CAAC,KAAK,mBAAmB,aAAa,iBAAiB,KAAK,mBAAmB,OAAO,CAAC,OAAO,oBAAoB,OAAO,CAAC,IAAI,EAAE,CAAC;AACzL,CAAC;AACD,MAAM,UAAU,wBAAwB,CAAC,OAAO,EAAE,IAAI;IACpD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,cAAc,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,aAAa,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YACvF,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,IAAI,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM;QAChF,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,CAAC,IAAI,aAAa,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;AACnF,CAAC"}

package/dist/cli.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function runCli(args?: any): Promise<any>;
+//# sourceMappingURL=cli.d.mts.map

package/dist/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","sourceRoot":"","sources":["../src/cli.mjs"],"names":[],"mappings":";AAgBA,wBAAsB,MAAM,CAAC,IAAI,MAAwB,gBAkBxD"}

package/dist/cli.mjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CliError, info } from './shared/cli-io.mjs';
+import { commandByName, renderCommandHelp, renderGlobalHelp, validateCommandArguments } from './cli/command-registry.mjs';
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const packageManifest = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+export async function runCli(args = process.argv.slice(2)) {
+    if (!args.length || ['--help', '-h'].includes(args[0]))
+        return info(renderGlobalHelp(packageManifest.version));
+    if (['--version', '-v'].includes(args[0]))
+        return info(packageManifest.version);
+    const command = commandByName(args[0]);
+    if (!command)
+        throw new CliError(`unknown command '${args[0]}'. Run flow --help.`);
+    if (args.slice(1).some((arg) => ['--help', '-h'].includes(arg)))
+        return info(renderCommandHelp(command));
+    try {
+        validateCommandArguments(command, args.slice(1));
+    }
+    catch (error) {
+        throw new CliError(error.message);
+    }
+    const module = await command.load();
+    return module[command.run]({
+        args: args.slice(1),
+        packageRoot,
+        packageName: packageManifest.name,
+        version: packageManifest.version
+    });
+}
+try {
+    await runCli();
+}
+catch (error) {
+    if (error?.code === 'ABORT_ERR') {
+        info('\nFlow command canceled.');
+        process.exitCode = 130;
+    }
+    else if (error instanceof CliError) {
+        console.error(`flow: ${error.message}`);
+        process.exitCode = error.exitCode || 1;
+    }
+    else
+        throw error;
+}
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

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

package/dist/commands/doctor.d.mts

@@ -0,0 +1,21 @@
+export declare function diagnoseProject(root: any, { quick, version, packageRoot }?: {
+    quick?: boolean | undefined;
+}): {
+    healthy: boolean;
+    mode: string;
+    checks: any[];
+    configured_version?: never;
+    executed_version?: never;
+} | {
+    healthy: boolean;
+    mode: string;
+    configured_version: string | null;
+    executed_version: any;
+    checks: any[];
+};
+export declare function runDoctor({ args, version, packageRoot }: {
+    args: any;
+    packageRoot: any;
+    version: any;
+}): void;
+//# sourceMappingURL=doctor.d.mts.map

package/dist/commands/doctor.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.mts","sourceRoot":"","sources":["../../src/commands/doctor.mjs"],"names":[],"mappings":"AAQA,wBAAgB,eAAe,CAAC,IAAI,KAAA,EAAE,EAAE,KAAa,EAAE,OAAO,EAAE,WAAW,EAAE;;CAAK;;;;;;;;;;;;EAwFjF;AAED,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE;;;;CAAA,QASvD"}

package/dist/commands/doctor.mjs

@@ -0,0 +1,79 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { parse } from 'yaml';
+import { info } from '../shared/cli-io.mjs';
+import { projectRoot } from '../shared/project-path.mjs';
+import { readConfig } from '../shared/project-config.mjs';
+import { validateProject } from './validate.mjs';
+export function diagnoseProject(root, { quick = false, version, packageRoot } = {}) {
+    const checks = [];
+    const add = (id, ok, message, recovery) => checks.push({ id, status: ok ? 'pass' : 'fail', message, ...(recovery ? { recovery } : {}) });
+    const flow = path.join(root, '_flow');
+    const legacyFlow = path.join(root, '.flow');
+    if (!fs.existsSync(flow) && fs.existsSync(legacyFlow)) {
+        add('flow-directory', false, 'Legacy .flow directory requires explicit migration to _flow.', 'Run flow migrate --plan.');
+        return {
+            healthy: false,
+            mode: quick ? 'quick' : 'full',
+            configured_version: null,
+            executed_version: version,
+            checks
+        };
+    }
+    add('flow-directory', fs.existsSync(flow), '_flow directory is present.', 'Run flow init.');
+    if (!fs.existsSync(flow))
+        return { healthy: false, mode: quick ? 'quick' : 'full', checks };
+    let config;
+    try {
+        config = readConfig(root);
+    }
+    catch (error) {
+        add('config', false, error.message, 'Repair config.yaml or run migration.');
+    }
+    add('config', Boolean(config), 'config.yaml is readable.', 'Run flow init.');
+    if (config) {
+        add('version', config.flow_version === version, `Project uses ${config.flow_version ?? 'an unversioned legacy release'}; CLI is ${version}.`, 'Update deliberately, then run flow migrate --plan.');
+        const skillCompatible = (config.runtimes ?? []).every((runtime) => fs.existsSync(path.join(root, runtime.skills_path, 'flow', 'SKILL.md')));
+        add('integrations', skillCompatible, 'Configured Flow skills are installed.', 'Run flow init to refresh configured integrations.');
+    }
+    for (const required of ['config.yaml', 'gates.yaml', 'work-items'])
+        add(`artifact:${required}`, fs.existsSync(path.join(flow, required)), `${required} is present.`, 'Restore it or run flow init.');
+    for (const schema of ['config', 'backlog', 'tasks', 'review', 'gates'])
+        add(`schema:${schema}`, fs.existsSync(path.join(packageRoot, 'schemas', `${schema}.schema.json`)), `${schema} schema is packaged.`, 'Reinstall the Flow package.');
+    if (!quick) {
+        const findings = validateProject(root, { skipTrace: false });
+        add('invariants', findings.length === 0, findings.length ? `${findings.length} validation finding(s).` : 'All structural invariants pass.', 'Run flow validate for details.');
+    }
+    else {
+        for (const file of ['gates.yaml']) {
+            const target = path.join(flow, file);
+            if (!fs.existsSync(target))
+                continue;
+            try {
+                parse(fs.readFileSync(target, 'utf8'));
+                add(`yaml:${file}`, true, `${file} parses.`);
+            }
+            catch (error) {
+                add(`yaml:${file}`, false, error.message, 'Repair or migrate the artifact.');
+            }
+        }
+    }
+    return {
+        healthy: checks.every((check) => check.status === 'pass'),
+        mode: quick ? 'quick' : 'full',
+        configured_version: config?.flow_version ?? null,
+        executed_version: version,
+        checks
+    };
+}
+export function runDoctor({ args, version, packageRoot }) {
+    const result = diagnoseProject(projectRoot(args), { quick: args.includes('--quick'), version, packageRoot });
+    if (args.includes('--json'))
+        info(JSON.stringify(result, null, 2));
+    else
+        for (const check of result.checks)
+            info(`${check.status === 'pass' ? 'PASS' : 'FAIL'} ${check.id}: ${check.message}${check.recovery && check.status === 'fail' ? ` ${check.recovery}` : ''}`);
+    if (!result.healthy)
+        process.exitCode = 1;
+}
+//# sourceMappingURL=doctor.mjs.map

package/dist/commands/doctor.mjs.map

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

package/dist/commands/gates.d.mts

@@ -0,0 +1,14 @@
+export declare function selectGates(gates: any, { ids, task, workItem, stage, all }?: {
+    all?: boolean | undefined;
+    ids?: never[] | undefined;
+    stage?: null | undefined;
+    task?: null | undefined;
+    workItem?: null | undefined;
+}): any;
+export declare function evaluateGates(root: any, filters?: {
+    all: boolean;
+}): any;
+export declare function runGates({ args }: {
+    args: any;
+}): void;
+//# sourceMappingURL=gates.d.mts.map

package/dist/commands/gates.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.d.mts","sourceRoot":"","sources":["../../src/commands/gates.mjs"],"names":[],"mappings":"AA0DA,wBAAgB,WAAW,CAAC,KAAK,KAAA,EAAE,EAAE,GAAQ,EAAE,IAAW,EAAE,QAAe,EAAE,KAAY,EAAE,GAAW,EAAE;;;;;;CAAK,OAkB5G;AAED,wBAAgB,aAAa,CAAC,IAAI,KAAA,EAAE,OAAO;IAAK,GAAG;CAAQ,OAY1D;AAOD,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE;;CAAA,QA6BhC"}

package/dist/commands/gates.mjs

@@ -0,0 +1,136 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fail } from '../shared/cli-io.mjs';
+import { parseGates } from '../artifacts/gates.mjs';
+function runCommandGate(root, gate) {
+    const shell = process.platform === 'win32' ? process.env.ComSpec || 'cmd.exe' : '/bin/sh';
+    const args = process.platform === 'win32' ? ['/d', '/s', '/c', gate.command] : ['-lc', gate.command];
+    const result = spawnSync(shell, args, { cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+    return {
+        id: gate.id,
+        kind: gate.kind,
+        blocking: gate.blocking,
+        status: result.status === 0 ? 'passed' : 'failed',
+        exit_code: result.status,
+        stdout: result.stdout,
+        stderr: result.stderr
+    };
+}
+function runBuiltinGate(root, gate) {
+    if (gate.rule !== 'kebab-case-files')
+        return {
+            id: gate.id,
+            kind: gate.kind,
+            blocking: gate.blocking,
+            status: 'unsupported',
+            message: `Unknown builtin rule '${gate.rule}'.`
+        };
+    const excluded = new Set(['.git', '_flow', 'node_modules']);
+    const violations = [];
+    function walk(directory) {
+        for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+            if (excluded.has(entry.name))
+                continue;
+            const full = path.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+                continue;
+            }
+            if (entry.name.startsWith('.'))
+                continue;
+            const ext = path.extname(entry.name);
+            const stem = ext ? entry.name.slice(0, -ext.length) : entry.name;
+            if (/^[A-Z0-9_.-]+$/.test(entry.name))
+                continue;
+            const valid = stem.split('.').every((segment) => /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(segment));
+            if (!valid)
+                violations.push(path.relative(root, full));
+        }
+    }
+    walk(root);
+    return {
+        id: gate.id,
+        kind: gate.kind,
+        blocking: gate.blocking,
+        status: violations.length ? 'failed' : 'passed',
+        violations
+    };
+}
+export function selectGates(gates, { ids = [], task = null, workItem = null, stage = null, all = false } = {}) {
+    return gates.filter((gate) => {
+        if (ids.length && !ids.includes(gate.id))
+            return false;
+        if (stage && gate.stage !== stage)
+            return false;
+        if (all)
+            return true;
+        if (task)
+            return ((gate.scope.tasks ?? []).includes(task) ||
+                (gate.scope.work_items ?? []).includes(task.split('-T')[0]) ||
+                (gate.stage === 'task' && !Object.keys(gate.scope).length));
+        if (workItem)
+            return ((gate.scope.work_items ?? []).includes(workItem) ||
+                (gate.stage === 'work-item-review' && !Object.keys(gate.scope).length));
+        return ids.length > 0 || Boolean(stage);
+    });
+}
+export function evaluateGates(root, filters = { all: true }) {
+    const file = path.join(root, '_flow', 'gates.yaml');
+    if (!fs.existsSync(file))
+        fail('gates.yaml does not exist.');
+    const { gates } = parseGates(fs.readFileSync(file, 'utf8'));
+    return selectGates(gates, filters).map((gate) => {
+        const startedAt = performance.now();
+        let result;
+        if (gate.kind === 'command')
+            result = runCommandGate(root, gate);
+        else if (gate.kind === 'builtin')
+            result = runBuiltinGate(root, gate);
+        else
+            throw new Error(`Unsupported gate kind '${gate.kind}'.`);
+        return { ...result, duration_ms: Math.round(performance.now() - startedAt) };
+    });
+}
+function option(args, name) {
+    const index = args.indexOf(name);
+    return index < 0 ? null : args[index + 1];
+}
+export function runGates({ args }) {
+    const root = path.resolve(option(args, '--path') ?? process.cwd());
+    const action = args.find((arg) => !arg.startsWith('-'));
+    const file = path.join(root, '_flow', 'gates.yaml');
+    if (!fs.existsSync(file))
+        fail('gates.yaml does not exist.');
+    const parsed = parseGates(fs.readFileSync(file, 'utf8'));
+    const filters = {
+        ids: option(args, '--id')?.split(',') ?? [],
+        task: option(args, '--task'),
+        workItem: option(args, '--work-item'),
+        stage: option(args, '--stage'),
+        all: args.includes('--all')
+    };
+    const hasFilter = filters.ids.length || filters.task || filters.workItem || filters.stage || filters.all;
+    if (action === 'list' && !hasFilter)
+        filters.all = true;
+    const selected = selectGates(parsed.gates, filters);
+    if (action === 'list') {
+        const output = args.includes('--json')
+            ? JSON.stringify(selected, null, 2)
+            : selected.map((gate) => `${gate.id}\t${gate.stage}\t${gate.cost}\t${gate.command ?? gate.rule}`).join('\n');
+        return console.log(output);
+    }
+    if (action !== 'run')
+        fail("flow gates requires 'list' or 'run'.");
+    if (!selected.length)
+        fail('No gates matched; use --all or a scope filter.');
+    const results = evaluateGates(root, filters);
+    if (args.includes('--json'))
+        console.log(JSON.stringify(results, null, 2));
+    else
+        for (const result of results)
+            console.log(`${result.status.toUpperCase()} ${result.id} (${result.duration_ms}ms)`);
+    if (results.some((result) => result.blocking && result.status !== 'passed'))
+        process.exitCode = 1;
+}
+//# sourceMappingURL=gates.mjs.map

package/dist/commands/gates.mjs.map

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

package/dist/commands/graph.d.mts

@@ -0,0 +1,11 @@
+import { ArtifactValidationError } from '../artifacts/backlog.mjs';
+export { ArtifactValidationError as GraphValidationError };
+export declare function generateGraphMarkdown(backlogText: any): string;
+export declare function writeGraph(root: any): {
+    graphPath: any;
+    markdown: string;
+};
+export declare function runGraph({ args }: {
+    args: any;
+}): void;
+//# sourceMappingURL=graph.d.mts.map

package/dist/commands/graph.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.mts","sourceRoot":"","sources":["../../src/commands/graph.mjs"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,EAIxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,uBAAuB,IAAI,oBAAoB,EAAE,CAAC;AAoB3D,wBAAgB,qBAAqB,CAAC,WAAW,KAAA,UA2ChD;AAED,wBAAgB,UAAU,CAAC,IAAI,KAAA;;;EAU9B;AAED,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE;;CAAA,QAGhC"}