@ai-content-space/loopx 0.1.9 → 0.2.0

package/src/cli.mjs

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 
 import { readFileSync } from 'node:fs';
+import { createInterface } from 'node:readline/promises';
 
 import { archiveStage, autopilotStage, approveStage, buildStage, clarifyStage, initWorkspace, planStage, reviewStage, statusSummary } from './workflow.mjs';
 import { renderHtmlViews } from './html-views.mjs';
-import { installBundledSkills } from './install-discovery.mjs';
+import { installBundledSkills, installSkillsForTargets } from './install-discovery.mjs';
 import { nextSkillCommand, withNextSkill } from './next-skill.mjs';
 import { doctorRuntime, migrateLegacyRuntime } from './runtime-maintenance.mjs';
 import { setupWorkspaceContext } from './workspace-context.mjs';
@@ -15,7 +16,7 @@ function usage() {
   return [
     'Usage:',
     '  loopx --version',
-    '  loopx init [--slug <slug>]',
+    '  loopx init [--slug <slug>] [--enable-agent-delegation] [--auto-agent-delegation] [--agent-delegation-threshold <local|critic-only|parallel-review>]',
     '  loopx clarify <slug> [--standard|--deep]',
     '  loopx approve <slug> --from <stage> --to <stage>',
     '  loopx plan [slug] [--direct <spec-path>] [--interactive] [--deliberate]',
@@ -27,12 +28,45 @@ function usage() {
     '  loopx render [slug|--all]',
     '  loopx status [slug] [--json]',
     '  loopx setup-context',
+    '  loopx install-skills [--target <codex|claude|all>] [--project] [--mode <copy|symlink>] [--dir <path>] [--yes]',
     '  loopx doctor',
     '  loopx migrate',
     '  loopx repair-install',
   ].join('\n');
 }
 
+async function promptInstallOptions() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const targetAnswer = (await rl.question('Install targets (codex, claude, all) [all]: ')).trim().toLowerCase();
+    const projectAnswer = (await rl.question('Install Claude project skills instead of user skills? [y/N]: ')).trim().toLowerCase();
+    const modeAnswer = (await rl.question('Install mode (copy, symlink) [copy]: ')).trim().toLowerCase();
+    const proceedAnswer = (await rl.question('Proceed? [y/N]: ')).trim().toLowerCase();
+    if (proceedAnswer !== 'y' && proceedAnswer !== 'yes') {
+      return null;
+    }
+    const target = targetAnswer || 'all';
+    return {
+      targets: target === 'all' ? ['codex', 'claude'] : [target],
+      project: projectAnswer === 'y' || projectAnswer === 'yes',
+      installMethod: modeAnswer === 'symlink' ? 'symlink' : 'copy',
+    };
+  } finally {
+    rl.close();
+  }
+}
+
+function installOptionsFromArgs(options) {
+  const target = String(options.get('--target') || 'all').trim().toLowerCase();
+  const targets = target === 'all' ? ['codex', 'claude'] : [target];
+  return {
+    targets,
+    project: Boolean(options.get('--project')),
+    installMethod: options.get('--mode') === 'symlink' ? 'symlink' : 'copy',
+    dir: options.get('--dir'),
+  };
+}
+
 function parseArgs(argv) {
   const [command, ...rest] = argv;
   const positionals = [];
@@ -90,6 +124,11 @@ function printHumanStatus(status) {
     console.log(`plan_architect_review_status: ${status.state.plan_architect_review_status}`);
     console.log(`plan_critic_verdict: ${status.state.plan_critic_verdict}`);
     console.log(`plan_artifact_status: ${status.state.plan_docs_status}`);
+    console.log(`plan_delegation_mode: ${status.state.plan_delegation_mode ?? 'unknown'}`);
+    console.log(`plan_delegation_recommended_mode: ${status.state.plan_delegation_recommended_mode ?? status.state.plan_delegation_mode ?? 'unknown'}`);
+    console.log(`plan_delegation_actual_mode: ${status.state.plan_delegation_actual_mode ?? 'unknown'}`);
+    console.log(`plan_delegation_authorization_status: ${status.state.plan_delegation_authorization_status ?? 'unknown'}`);
+    console.log(`plan_delegation_decision_path: ${status.state.plan_delegation_decision_path ?? '(none)'}`);
     console.log(`source_requirements_status: ${status.state.source_requirements_status ?? 'unknown'}`);
     console.log(`requirement_traceability_path: ${status.state.requirement_traceability_path ?? '(none)'}`);
     console.log(`plan_blockers: ${Array.isArray(status.state.plan_blockers) && status.state.plan_blockers.length > 0 ? status.state.plan_blockers.join(', ') : '(none)'}`);
@@ -156,7 +195,14 @@ async function main() {
   try {
     switch (command) {
       case 'init': {
-        const result = await initWorkspace(process.cwd(), { slug: options.get('--slug') || positionals[0] });
+        const result = await initWorkspace(process.cwd(), {
+          slug: options.get('--slug') || positionals[0],
+          agentDelegation: {
+            enabled: Boolean(options.get('--enable-agent-delegation') || options.get('--auto-agent-delegation')),
+            auto_start: Boolean(options.get('--auto-agent-delegation')),
+            threshold: options.get('--agent-delegation-threshold'),
+          },
+        });
         console.log(JSON.stringify({ ok: true, command, workspaceRoot: result.workspaceRoot, workflow: result.workflow?.state ?? null }, null, 2));
         return;
       }
@@ -165,6 +211,21 @@ async function main() {
         console.log(JSON.stringify({ ok: true, command, contextSetup }, null, 2));
         return;
       }
+      case 'install-skills': {
+        const installOptions = process.stdin.isTTY && !options.get('--target') && !options.get('--yes')
+          ? await promptInstallOptions()
+          : installOptionsFromArgs(options);
+        if (!installOptions) {
+          console.log(JSON.stringify({ ok: false, command, cancelled: true }, null, 2));
+          return;
+        }
+        const result = await installSkillsForTargets({
+          ...process.env,
+          LOOPX_INSTALL_CWD: process.cwd(),
+        }, installOptions);
+        console.log(JSON.stringify({ ok: result.ok, command, ...result }, null, 2));
+        return;
+      }
       case 'clarify': {
         const profile = options.get('--deep') ? 'deep' : 'standard';
         const result = await clarifyStage(process.cwd(), positionals[0], { profile });
@@ -243,9 +304,22 @@ async function main() {
         return;
       }
       case 'repair-install': {
-        const result = await installBundledSkills(process.env);
+        const result = await installSkillsForTargets({
+          ...process.env,
+          LOOPX_INSTALL_CWD: process.cwd(),
+        });
         const ok = result.ok !== false;
-        console.log(JSON.stringify({ ok, command, ...result }, null, 2));
+        const codex = result.results?.codex || {};
+        console.log(JSON.stringify({
+          ok,
+          command,
+          ...result,
+          installed: codex.installed || [],
+          conflicts: codex.conflicts || [],
+          skipped: codex.skipped || [],
+          templateGovernance: codex.templateGovernance,
+          inspection: codex.inspection,
+        }, null, 2));
         if (!ok) {
           process.exitCode = 1;
         }

package/src/context-manifest.mjs

@@ -134,7 +134,7 @@ export async function generateBuildContextManifest({ cwd, root, state, slug }) {
     row(cwd, { stage: 'build', kind: 'architecture', path: join(root, 'architecture.md'), reason: 'architecture_constraints', priority: 21 }),
     row(cwd, { stage: 'build', kind: 'development-plan', path: join(root, 'development-plan.md'), reason: 'execution_steps', priority: 22 }),
     row(cwd, { stage: 'build', kind: 'test-plan', path: join(root, 'test-plan.md'), reason: 'verification_strategy', priority: 23 }),
-    row(cwd, { stage: 'build', kind: 'prd', path: state.plan_artifact_path || join(cwd, '.loopx', 'plans', `prd-${slug}.md`), reason: 'requirements', priority: 30 }),
+    row(cwd, { stage: 'build', kind: 'requirements-snapshot', path: state.plan_artifact_path || join(cwd, '.loopx', 'plans', `requirements-snapshot-${slug}.md`), reason: 'approved_requirements_snapshot', priority: 30 }),
     row(cwd, { stage: 'build', kind: 'test-spec', path: state.test_spec_artifact_path || join(cwd, '.loopx', 'plans', `test-spec-${slug}.md`), reason: 'test_requirements', priority: 31 }),
     row(cwd, { stage: 'build', kind: 'vertical-slices', path: state.change_artifact_paths?.slices || join(cwd, '.loopx', 'changes', 'active', state.change_id || `chg-${slug}`, 'slices.json'), reason: 'end_to_end_delivery_slices', priority: 32 }),
     row(cwd, { stage: 'build', kind: 'review-rework', path: reviewReworkPath, reason: 'review_requested_implementation_fixes', priority: 33, required: requiresReviewRework }),
@@ -155,7 +155,7 @@ export async function generateReviewContextManifest({ cwd, root, state, slug })
     row(cwd, { stage: 'review', kind: 'source-requirements', path: state.plan_source_spec_path || join(root, 'spec.md'), reason: 'original_requirements_source_of_truth', priority: 11 }),
     row(cwd, { stage: 'review', kind: 'requirement-traceability', path: state.requirement_traceability_path || join(root, 'requirement-traceability.md'), reason: 'source_requirement_coverage_gate', priority: 12 }),
     row(cwd, { stage: 'review', kind: 'test-spec', path: state.test_spec_artifact_path || join(cwd, '.loopx', 'plans', `test-spec-${slug}.md`), reason: 'acceptance_tests', priority: 20 }),
-    row(cwd, { stage: 'review', kind: 'prd', path: state.plan_artifact_path || join(cwd, '.loopx', 'plans', `prd-${slug}.md`), reason: 'requirements', priority: 21 }),
+    row(cwd, { stage: 'review', kind: 'requirements-snapshot', path: state.plan_artifact_path || join(cwd, '.loopx', 'plans', `requirements-snapshot-${slug}.md`), reason: 'approved_requirements_snapshot', priority: 21 }),
     row(cwd, { stage: 'review', kind: 'vertical-slices', path: state.change_artifact_paths?.slices || join(cwd, '.loopx', 'changes', 'active', state.change_id || `chg-${slug}`, 'slices.json'), reason: 'slice_verification_contract', priority: 22 }),
     row(cwd, { stage: 'review', kind: 'domain-context', path: contextPaths.domainGlossary, reason: 'terminology_and_boundary_review', priority: 23, required: contextSetup.status !== 'missing' }),
     row(cwd, { stage: 'review', kind: 'changed-files', path: join(root, 'review-support', 'changed-files.json'), reason: 'changed_file_evidence', priority: 25, required: false }),