@event4u/agent-config 2.26.0 → 3.1.0

package/config/agent-settings.template.yml

@@ -61,13 +61,6 @@ personal:
   # Automatically open edited files in the IDE (true, false)
   open_edited_files: false
 
-  # User's first name — used to address the user personally
-  # NOTE (legacy fallback): Source of truth for user identity is now the
-  # project-root `.agent-user.md` file, created via `/agents user init`.
-  # This key is retained for backward compatibility; the agent only falls
-  # back to it when `.agent-user.md` is absent.
-  user_name: ""
-
   # rtk (Rust Token Killer) installed for output filtering (true, false)
   # Agent will auto-detect and ask once, then store the result
   rtk_installed: false
@@ -147,7 +140,7 @@ eloquent:
 
 # --- Chat history (crash recovery) ---
 #
-# Persistent JSONL log at agents/.agent-chat-history (git-ignored).
+# Persistent JSONL log at agents/runtime/.agent-chat-history (git-ignored).
 # Keeps a durable record of the conversation so a crashed or switched
 # agent session can be resumed. See scripts/chat_history.py for the API.
 chat_history:
@@ -496,3 +489,13 @@ decision_engine:
 # matrix and the road-to-portable-runtime-and-update-check roadmap (P2).
 update_check:
   enabled: true
+
+# ─── explain ──────────────────────────────────────────────────────────────
+# `agent-config explain last` renders the read-only execution trace for the
+# most recent /work run (state file `.work-state.json`). Trace output is
+# PII-scrubbed before emission; the command never makes network calls and
+# never writes to state. Set `enable_last: false` to suppress the subcommand
+# (the call still exits 0 with a one-line notice — used by air-gapped
+# tenants that disable diagnostics surface-wide).
+explain:
+  enable_last: true

package/config/discovery/packs.yml

@@ -0,0 +1,162 @@
+# Discovery packs — closed vocabulary
+#
+# Source of truth: docs/decisions/ADR-013-discovery-frontmatter-contract.md §packs
+# Amendments require an ADR-013 amendment in the same PR.
+# `requires_hint` is advisory metadata only; runtime does NOT act on it.
+# Lint: scripts/lint_discovery_vocabulary.py
+
+- id: engineering-base
+  label: Engineering Base
+  description: Framework-neutral engineering hygiene — git, tests, reviews.
+  workspaces: [engineering]
+  trust_level_default: core
+
+- id: php
+  label: PHP
+  description: PHP-language patterns (framework-free).
+  workspaces: [engineering]
+  requires_hint: [engineering-base]
+  trust_level_default: professional
+
+- id: laravel
+  label: Laravel
+  description: Laravel framework patterns; depends on PHP at the artefact level.
+  workspaces: [engineering]
+  requires_hint: [php, engineering-base]
+  trust_level_default: professional
+
+- id: symfony
+  label: Symfony
+  description: Symfony framework patterns; depends on PHP at the artefact level.
+  workspaces: [engineering]
+  requires_hint: [php, engineering-base]
+  trust_level_default: professional
+
+- id: javascript
+  label: JavaScript
+  description: JavaScript-language patterns.
+  workspaces: [engineering]
+  requires_hint: [engineering-base]
+  trust_level_default: professional
+
+- id: typescript
+  label: TypeScript
+  description: TypeScript-language patterns.
+  workspaces: [engineering]
+  requires_hint: [javascript, engineering-base]
+  trust_level_default: professional
+
+- id: react
+  label: React
+  description: React framework patterns.
+  workspaces: [engineering]
+  requires_hint: [javascript, engineering-base]
+  trust_level_default: professional
+
+- id: nextjs
+  label: Next.js
+  description: Next.js framework patterns.
+  workspaces: [engineering]
+  requires_hint: [react, typescript, engineering-base]
+  trust_level_default: professional
+
+- id: python
+  label: Python
+  description: Python-language patterns.
+  workspaces: [engineering]
+  requires_hint: [engineering-base]
+  trust_level_default: professional
+
+- id: product-basic
+  label: Product Basic
+  description: Core PO/PM artefacts (ticket refinement, AC, estimation).
+  workspaces: [product]
+  trust_level_default: professional
+
+- id: product-discovery
+  label: Product Discovery
+  description: JTBD, interviews, VoC, hypothesis testing.
+  workspaces: [product]
+  requires_hint: [product-basic]
+  trust_level_default: professional
+
+- id: finance-basic
+  label: Finance Basic
+  description: Cashflow, runway, basic forecasting.
+  workspaces: [finance, founder]
+  trust_level_default: professional
+  onboarding:
+    first_win_doc: FIRST_WIN.md
+    example_workflow: runway-cognition
+    time_to_first_value_minutes: 8
+
+- id: finance-advanced
+  label: Finance Advanced
+  description: DCF, scenario modelling, comp banding.
+  workspaces: [finance]
+  requires_hint: [finance-basic]
+  trust_level_default: core
+
+- id: gtm-sales
+  label: GTM — Sales
+  description: Pipeline, MEDDIC, forecast accuracy.
+  workspaces: [gtm]
+  trust_level_default: professional
+  onboarding:
+    first_win_doc: FIRST_WIN.md
+    example_workflow: deal-qualification-meddic
+    time_to_first_value_minutes: 7
+
+- id: gtm-marketing
+  label: GTM — Marketing
+  description: Positioning, messaging, editorial, content funnel.
+  workspaces: [gtm, founder]
+  trust_level_default: professional
+
+- id: ops-people
+  label: Operations — People
+  description: Hiring loops, onboarding programs, comp banding.
+  workspaces: [ops]
+  trust_level_default: professional
+  onboarding:
+    first_win_doc: FIRST_WIN.md
+    example_workflow: one-on-one-cadence
+    time_to_first_value_minutes: 6
+
+- id: founder-strategy
+  label: Founder — Strategy
+  description: Vision, fundraising narrative, competitive moat.
+  workspaces: [founder]
+  trust_level_default: core
+  onboarding:
+    first_win_doc: FIRST_WIN.md
+    example_workflow: vision-articulation
+    time_to_first_value_minutes: 10
+
+- id: small-business
+  label: Small Business
+  description: SMB-shaped owner workflows.
+  workspaces: [small-business]
+  trust_level_default: professional
+
+- id: construction
+  label: Construction
+  description: Trade-business workflows.
+  workspaces: [construction]
+  trust_level_default: professional
+
+- id: ai-video
+  label: AI Video
+  description: AI video pipeline (per ADR-011, the only heavyweight domain).
+  workspaces: [small-business]
+  trust_level_default: experimental
+  onboarding:
+    first_win_doc: FIRST_WIN.md
+    example_workflow: scene-expander
+    time_to_first_value_minutes: 12
+
+- id: meta
+  label: Meta
+  description: Artefacts that maintain this package (agent-config itself).
+  workspaces: [agent-config-maintainer]
+  trust_level_default: core

package/config/discovery/unassigned-artefacts.yml

@@ -0,0 +1,68 @@
+# Discovery — unassigned-artefact quarantine
+#
+# Catch-all for artefacts that legitimately resist workspace/pack
+# assignment. Each entry MUST carry a `reason:` field.
+#
+# Stays empty through Phases 1–3 of
+# `agents/roadmaps/archive/automated-pack-workspace-and-skill-discovery.md`
+# (archived, status: completed). Phase 4 populated it with the
+# genuinely cross-cutting cases listed below.
+#
+# Lint: scripts/lint_artefact_frontmatter.py (added in Phase 6)
+# Schema entry shape:
+#
+#   - path: <repo-relative-path-to-artefact>
+#     reason: <one-line explanation>
+
+# Scaffold templates — markdown skeletons consumed by `/agents init`,
+# /skill-management, /override:create, etc. They carry no runtime
+# frontmatter on purpose: the consuming command fills it in. Quarantined
+# from the discovery manifest so strict mode stays clean.
+- path: .agent-src.uncompressed/templates/AGENTS.md
+  reason: scaffold template for new project AGENTS.md; placeholders filled by /agents init
+- path: .agent-src.uncompressed/templates/agent-settings.md
+  reason: scaffold for project .agent-settings.yml
+- path: .agent-src.uncompressed/templates/command.md
+  reason: scaffold for new slash-command authoring
+- path: .agent-src.uncompressed/templates/contexts.md
+  reason: scaffold index for project contexts/
+- path: .agent-src.uncompressed/templates/contexts/auth-model.md
+  reason: scaffold for project auth-model context
+- path: .agent-src.uncompressed/templates/contexts/data-sensitivity.md
+  reason: scaffold for project data-sensitivity context
+- path: .agent-src.uncompressed/templates/contexts/deployment-order.md
+  reason: scaffold for project deployment-order context
+- path: .agent-src.uncompressed/templates/contexts/observability.md
+  reason: scaffold for project observability context
+- path: .agent-src.uncompressed/templates/contexts/tenant-boundaries.md
+  reason: scaffold for project tenant-boundaries context
+- path: .agent-src.uncompressed/templates/copilot-instructions.md
+  reason: scaffold for project copilot-instructions.md
+- path: .agent-src.uncompressed/templates/features.md
+  reason: scaffold for project features.md catalogue
+- path: .agent-src.uncompressed/templates/overrides/command.md
+  reason: scaffold for project override of a shared command
+- path: .agent-src.uncompressed/templates/overrides/guideline.md
+  reason: scaffold for project override of a shared guideline
+- path: .agent-src.uncompressed/templates/overrides/rule.md
+  reason: scaffold for project override of a shared rule
+- path: .agent-src.uncompressed/templates/overrides/skill.md
+  reason: scaffold for project override of a shared skill
+- path: .agent-src.uncompressed/templates/overrides/template.md
+  reason: scaffold-of-scaffold for new override types
+- path: .agent-src.uncompressed/templates/persona.md
+  reason: scaffold for new persona authoring
+- path: .agent-src.uncompressed/templates/roadmaps.md
+  reason: scaffold for new roadmap authoring
+- path: .agent-src.uncompressed/templates/rule.md
+  reason: scaffold for new rule authoring
+- path: .agent-src.uncompressed/templates/scripts/.pytest_cache/README.md
+  reason: pytest cache artefact, not an agent-config artefact
+- path: .agent-src.uncompressed/templates/scripts/README.md
+  reason: scaffold README for project scripts/
+- path: .agent-src.uncompressed/templates/skill-archive-note.md
+  reason: scaffold for archive-note generation
+- path: .agent-src.uncompressed/templates/skill.md
+  reason: scaffold for new SKILL.md authoring
+- path: .agent-src.uncompressed/README.md
+  reason: package-root orientation; carries no artefact frontmatter — follows package core

package/config/discovery/workspaces.yml

@@ -0,0 +1,59 @@
+# Discovery workspaces — closed vocabulary
+#
+# Source of truth: docs/decisions/ADR-013-discovery-frontmatter-contract.md §workspaces
+# Amendments require an ADR-013 amendment in the same PR.
+# Lint: scripts/lint_discovery_vocabulary.py
+
+- id: engineering
+  label: Engineering
+  description: Code, tests, CI, reviews, architecture.
+  default_packs: [engineering-base]
+  optional_packs: [php, laravel, symfony, javascript, typescript, react, nextjs, python]
+
+- id: product
+  label: Product
+  description: Discovery, roadmaps, prioritisation, AC tightening.
+  default_packs: [product-basic]
+  optional_packs: [product-discovery]
+
+- id: finance
+  label: Finance / CFO
+  description: Cashflow, forecasting, DCF, board reporting.
+  default_packs: [finance-basic]
+  optional_packs: [finance-advanced]
+
+- id: founder
+  label: Founder
+  description: Strategy, fundraising, vision, board narrative.
+  default_packs: [founder-strategy]
+  optional_packs: [finance-basic, gtm-marketing]
+
+- id: gtm
+  label: Go-to-Market
+  description: Sales pipeline, marketing, positioning, launch.
+  default_packs: [gtm-sales, gtm-marketing]
+  optional_packs: []
+
+- id: ops
+  label: Operations
+  description: Hiring, comp, perf, org design, runbooks.
+  default_packs: [ops-people]
+  optional_packs: []
+
+- id: small-business
+  label: Small Business
+  description: Self-employed / SMB-shaped owner workflows.
+  default_packs: [small-business]
+  optional_packs: [ai-video]
+
+- id: construction
+  label: Construction
+  description: Trade-business workflows (planning, quotes).
+  default_packs: [construction]
+  optional_packs: []
+
+- id: agent-config-maintainer
+  label: Maintainer
+  description: Skills/rules/commands that maintain this package.
+  default_packs: [meta]
+  optional_packs: []

package/config/gitignore-block.txt

@@ -1,14 +1,30 @@
-# Agent config — symlinked from vendor (auto-managed)
+# Agent config — tool-scope leftovers (ADR-020 § global-only consumer
+# install). After the Phase-5 migration the entire `.augment/`, `.claude/`,
+# `.cursor/` trees live under `~/.event4u/agent-config/`; consumers carry
+# only `agents/overrides/` + `agents/.event4u-bridge.yml`. The per-tool
+# bridge pointer files for Windsurf / Cline / Gemini-CLI live under
+# `.windsurf/`, `.clinerules/`, `.gemini/` and ARE committed — those
+# directories stay tracked (not listed here). Pre-Phase-5 entries kept
+# as a defence-in-depth ignore list for legacy installs that have not
+# migrated yet — Phase 5 unstages them on first migrate run.
 .augment/skills/
 .augment/commands/
 .augment/guidelines/
 .augment/templates/
 .augment/contexts/
 .augment/scripts/
+.augment/rules/
 .augment/README.md
+.claude/skills/
+.claude/commands/
+.claude/agents/
+.claude/CLAUDE.md
+.cursor/rules/
 
-# Agent config — NOT ignored (real copies, may contain project overrides)
-# .augment/rules/
+# Agent config — Phase 5 migration snapshot (ADR-020). Written by
+# `agent-config migrate-to-global` as a copy-then-move safety net so a
+# migration can be rolled back. Local-only — never commit.
+.legacy-pre-global-only/
 
 # Agent config — CLI wrapper (auto-generated on every install)
 /agent-config
@@ -37,7 +53,10 @@
 !/agents/ghostwriter/README.md
 /agents/ghostwriter/*.md.bak
 
-# Agent config — persistent chat history (crash recovery, never commit)
+# Agent config — legacy chat-history flat path. Current installs put
+# the file at agents/runtime/.agent-chat-history (covered by the
+# /agents/runtime/ catch-all below). Kept for back-compat with older
+# installs that have not migrated yet.
 /agents/.agent-chat-history
 /agents/.agent-chat-history.bak
 /agents/.agent-chat-history.*.bak
@@ -46,23 +65,17 @@
 .agent-engagement.jsonl
 .agent-engagement.jsonl.bak
 
-# Agent config — AI Council price table (refreshed weekly, never commit)
-/agents/.agent-prices.md
+# Agent config — volatile runtime artefacts (machine-generated,
+# regenerated on demand, never committed). Single catch-all per the
+# Volatile Runtime policy: everything under agents/runtime/ is
+# local-only — price cache, council questions/responses/sessions,
+# council events log, Tier 1 hook runtime state, chat-history, budget
+# history, density / frugality / logs / mcp-telemetry / tmp scratch.
+# Durable evidence cited from docs / ADRs lives in agents/evidence/;
+# decision records in agents/decisions/.
+/agents/runtime/
 
-# Agent config — AI Council artefacts (questions, responses, sessions).
-# Dev-time scratch — informs decisions, never the durable contract.
-# See ai-council § Output path convention.
-/agents/council-questions/
-/agents/council-responses/
-/agents/council-sessions/
-
-# Agent config — AI Council persistent events log (step-8 D3).
-# Local JSONL audit trail for necessity / quota decisions. Hashes
-# original_ask before write but is still considered private. Set
-# AGENT_CONFIG_NO_EVENTS_LOG=1 to disable writes entirely.
-/agents/council-events.log
-
-# Agent config — Tier 1 hook runtime state (context-hygiene.json,
-# onboarding-gate.json). Written by SessionStart / PostToolUse hooks
-# on Augment + Claude Code; regenerated on demand, never commit.
-/agents/state/
+# Agent config — unified-setup wizard partial state (Roadmap R2 Phase 1).
+# Written by POST /api/v1/wizard/state between step transitions, deleted
+# on POST /api/v1/wizard/finish. Local-only crash-recovery aid.
+/.agent-config/wizard-state.json

package/dist/cli/agent-config.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+/**
+ * `agent-config` — TS shell entry point.
+ *
+ * Phase 2 behaviour:
+ *   - Parses `--version`, `--help`, `versions`, `doctor-shell` natively.
+ *   - Forwards every other registered subcommand to the Bash dispatcher
+ *     via `delegateToBash` (preserves all existing dispatch logic).
+ *   - Unknown subcommands also forward (the Bash dispatcher prints
+ *     the canonical "unknown command" error) so the TS shell never
+ *     drifts from the Bash subcommand surface.
+ *
+ * Phase 5 will reverse the delegation direction.
+ */
+import { readFileSync } from 'node:fs';
+import { Command } from 'commander';
+import { PACKAGE_JSON } from './paths.js';
+import { delegateToBash } from './bash/runBash.js';
+import { runVersions } from './commands/versions.js';
+import { runDoctorShell } from './commands/doctorShell.js';
+import { runUiServe } from './commands/uiServe.js';
+import { runSettings } from './commands/settings.js';
+import { runWorkspacesLs } from './commands/workspaces.js';
+import { runPacksLs } from './commands/packs.js';
+import { logger } from './log/logger.js';
+import { REGISTRY } from './registry.js';
+function readVersion() {
+    const pkg = JSON.parse(readFileSync(PACKAGE_JSON, 'utf8'));
+    return typeof pkg.version === 'string' ? pkg.version : '0.0.0';
+}
+function buildHelp() {
+    const lines = [
+        'agent-config — event4u/agent-config CLI (TS shell)',
+        '',
+        'Usage:',
+        '  agent-config <command> [options]',
+        '  agent-config --help',
+        '  agent-config --version',
+        '',
+        'Native commands (TS shell):',
+    ];
+    for (const entry of REGISTRY) {
+        if (entry.disposition !== 'native')
+            continue;
+        const synopsis = entry.synopsis ?? '';
+        lines.push(`  ${entry.name.padEnd(22)} ${synopsis}`);
+    }
+    lines.push('');
+    lines.push('All other subcommands delegate to the Bash dispatcher.');
+    lines.push('Run `agent-config help --tier=all` for the full Bash-side surface.');
+    return lines.join('\n');
+}
+async function main(argv) {
+    const program = new Command();
+    program
+        .name('agent-config')
+        .description('event4u/agent-config CLI shell')
+        .version(readVersion(), '-V, --version', 'Print package version')
+        .helpOption('-h, --help', 'Show this help')
+        .allowUnknownOption(true)
+        .allowExcessArguments(true);
+    program
+        .command('versions')
+        .description('List @event4u/agent-config versions')
+        .option('--offline', 'Skip npm registry probe')
+        .option('--json', 'Emit machine-readable JSON')
+        .option('--limit <n>', 'Show at most N recent versions', (v) => Number.parseInt(v, 10), 10)
+        .action(async (opts) => {
+        const code = await runVersions(opts);
+        process.exit(code);
+    });
+    program
+        .command('doctor-shell')
+        .description('Probe the TS-shell environment')
+        .action(() => {
+        const code = runDoctorShell();
+        process.exit(code);
+    });
+    program
+        .command('ui:serve')
+        .description('Start the local UI server (127.0.0.1, auto-picked port)')
+        .option('--port <n>', 'Override the auto-picked port', (v) => Number.parseInt(v, 10))
+        .option('--no-open', 'Do not launch the browser')
+        .option('--ui-dist <path>', 'Override the dist/ui directory')
+        .option('--allow-headless', 'Start even when SSH/no-DISPLAY is detected')
+        .option('--project-root <path>', 'Override the project root used to resolve .agent-config/')
+        .option('--dry-run', 'Boot with all writes suppressed (preview-only — no .agent-settings.yml / .agent-user.md / wizard-state.json mutations)')
+        .action(async (opts) => {
+        const code = await runUiServe(opts);
+        process.exit(code);
+    });
+    program
+        .command('settings')
+        .description('Open the local Settings GUI (boots the UI server and lands on #/settings)')
+        .option('--port <n>', 'Override the auto-picked port', (v) => Number.parseInt(v, 10))
+        .option('--no-open', 'Do not launch the browser')
+        .option('--ui-dist <path>', 'Override the dist/ui directory')
+        .option('--allow-headless', 'Start even when SSH/no-DISPLAY is detected')
+        .option('--project-root <path>', 'Override the project root used to resolve .agent-config/')
+        .option('--dry-run', 'Boot with all writes suppressed (preview-only)')
+        .action(async (opts) => {
+        const code = await runSettings(opts);
+        process.exit(code);
+    });
+    // `setup` — onboarding-only alias for `ui:serve` that lands on the
+    // `#/wizard` route. Replaces the deprecated `/onboard` chat skill.
+    program
+        .command('setup')
+        .description('Open the onboarding wizard (boots the UI server and lands on #/wizard)')
+        .option('--port <n>', 'Override the auto-picked port', (v) => Number.parseInt(v, 10))
+        .option('--no-open', 'Do not launch the browser')
+        .option('--ui-dist <path>', 'Override the dist/ui directory')
+        .option('--allow-headless', 'Start even when SSH/no-DISPLAY is detected')
+        .option('--project-root <path>', 'Override the project root used to resolve .agent-config/')
+        .option('--dry-run', 'Boot with all writes suppressed (preview-only)')
+        .action(async (opts) => {
+        const forwarded = { initialRoute: '/wizard' };
+        if (opts.port !== undefined)
+            forwarded.port = opts.port;
+        if (opts.open !== undefined)
+            forwarded.open = opts.open;
+        if (opts.uiDist !== undefined)
+            forwarded.uiDist = opts.uiDist;
+        if (opts.allowHeadless !== undefined)
+            forwarded.allowHeadless = opts.allowHeadless;
+        if (opts.projectRoot !== undefined)
+            forwarded.projectRoot = opts.projectRoot;
+        if (opts.dryRun !== undefined)
+            forwarded.dryRun = opts.dryRun;
+        const code = await runUiServe(forwarded);
+        process.exit(code);
+    });
+    const workspaces = program
+        .command('workspaces')
+        .description('Inspect workspaces from the discovery manifest');
+    workspaces
+        .command('ls')
+        .description('List workspaces (id, label, default_packs)')
+        .option('--json', 'Emit machine-readable JSON')
+        .action((opts) => {
+        const code = runWorkspacesLs(opts);
+        process.exit(code);
+    });
+    const packs = program
+        .command('packs')
+        .description('Inspect packs from the discovery manifest');
+    packs
+        .command('ls')
+        .description('List packs (id, label, workspaces, artefact_count)')
+        .option('--json', 'Emit machine-readable JSON')
+        .action((opts) => {
+        const code = runPacksLs(opts);
+        process.exit(code);
+    });
+    program
+        .command('help')
+        .description('Show help (delegates to Bash for --tier=1|all)')
+        .allowUnknownOption(true)
+        .allowExcessArguments(true)
+        .action(async () => {
+        const rest = argv.slice(argv.indexOf('help') + 1);
+        if (rest.length === 0) {
+            process.stdout.write(`${buildHelp()}\n`);
+            process.exit(0);
+        }
+        const code = await delegateToBash({ args: ['help', ...rest] });
+        process.exit(code);
+    });
+    // Bare invocation → print TS-shell help.
+    if (argv.length === 0) {
+        process.stdout.write(`${buildHelp()}\n`);
+        return 0;
+    }
+    const head = argv[0];
+    if (head === '--help' || head === '-h') {
+        process.stdout.write(`${buildHelp()}\n`);
+        return 0;
+    }
+    if (head === '--version' || head === '-V') {
+        process.stdout.write(`${readVersion()}\n`);
+        return 0;
+    }
+    // Native subcommand → commander handles it (exits inside action).
+    const native = ['versions', 'doctor-shell', 'ui:serve', 'settings', 'setup', 'workspaces', 'packs', 'help'];
+    if (head !== undefined && native.includes(head)) {
+        await program.parseAsync(['node', 'agent-config', ...argv]);
+        return 0;
+    }
+    // Everything else forwards to the Bash dispatcher verbatim.
+    return delegateToBash({ args: argv });
+}
+main(process.argv.slice(2))
+    .then((code) => { process.exit(code); })
+    .catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    logger.error(message);
+    process.exit(1);
+});
+//# sourceMappingURL=agent-config.js.map

package/dist/cli/agent-config.js.map

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

package/dist/cli/bash/runBash.js

@@ -0,0 +1,40 @@
+/**
+ * Bash-dispatcher delegate.
+ *
+ * Phase 2 strategy: the TS binary keeps the existing Bash dispatcher
+ * (`scripts/agent-config`) as the canonical router. Native commands
+ * (`versions`, `doctor-shell`, `--help`, `--version`) are handled in
+ * TS; every other subcommand is forwarded verbatim with `exec`-style
+ * semantics (`stdio: 'inherit'`, exit code propagated).
+ *
+ * Phase 5 (Shadow-Mode → flip) will reverse this: Bash becomes a thin
+ * shim that forwards to TS. The contract here is exit-code parity.
+ */
+import { execa } from 'execa';
+import { BASH_ENTRY } from '../paths.js';
+import { logger } from '../log/logger.js';
+/**
+ * Forward to the Bash dispatcher. Returns the child's exit code; the
+ * caller is responsible for `process.exit(code)`.
+ *
+ * Errors thrown by execa (ENOENT, non-executable file, …) are caught
+ * and reported via the logger; we exit with code 127 in that case so
+ * the failure is distinguishable from a normal subcommand non-zero.
+ */
+export async function delegateToBash(opts) {
+    try {
+        const child = execa('bash', [BASH_ENTRY, ...opts.args], {
+            stdio: 'inherit',
+            reject: false,
+            env: process.env,
+        });
+        const result = await child;
+        return result.exitCode ?? 1;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error(`failed to invoke Bash dispatcher: ${message}`);
+        return 127;
+    }
+}
+//# sourceMappingURL=runBash.js.map

package/dist/cli/bash/runBash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runBash.js","sourceRoot":"","sources":["../../../src/cli/bash/runBash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAO1C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAyB;IAC1D,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE;YACpD,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;SACnB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QAC3B,OAAO,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,GAAG,CAAC;IACf,CAAC;AACL,CAAC"}