opensip-cli 0.1.0

package/dist/commands/host-subcommand-groups.js

@@ -0,0 +1,374 @@
+// @fitness-ignore-file file-length-limit -- deliberate single cycle-free leaf module: it houses BOTH host subcommand groups' leaf specs (sessions + plugin) AND the completion inventory together specifically because it must import neither completion.ts nor host-command-specs.ts (see header — splitting would reintroduce the module cycle this file exists to break). Cohesive by design; grew past the 400-line soft limit with the per-leaf CommandSpec builders.
+/**
+ * host-subcommand-groups — the action-less Commander subcommand GROUPS
+ * (`sessions`, `plugin`) and their leaf {@link CommandSpec}s (launch
+ * Phase 6).
+ *
+ * Split out of `host-command-specs.ts` for ONE reason: to break a module cycle.
+ * The completion-script generator (`completion.ts`) sources its `plugin` /
+ * `sessions` sub-subcommand NAME lists from the live leaf specs (single source —
+ * Phase 6 Task 6.2), so it must import the group inventory. The
+ * `host-command-specs.ts` module, in turn, imports `printCompletionScript` from
+ * `completion.ts` for the `completion` command's handler. Housing the GROUP
+ * leaves + inventory here (a module that imports NEITHER `completion.ts` nor
+ * `host-command-specs.ts`) lets both depend on this leaf module without a cycle.
+ *
+ * The two parents are action-less GROUPS — a parent with no action body is not
+ * a single mountable `CommandSpec`, so it stays a raw `program.command(name)`
+ * shell (the FINITE, NAMED documented exceptions for the Phase 7
+ * `command-surface-parity` guardrail's allow-list, see {@link HOST_SUBCOMMAND_GROUPS}).
+ * Their LEAVES (`sessions list|purge`, `plugin list|add|remove|sync`) ARE specs.
+ */
+import { currentScope, defineCommand, } from '@opensip-cli/core';
+import { executeClear } from './clear.js';
+import { showHistory } from './history.js';
+import { pluginAdd, pluginList, pluginRemove, pluginSync } from './plugin.js';
+import { executeSessionShow } from './session-show.js';
+import { buildToolsGroupLeaves } from './tools/index.js';
+/** Every grouped leaf needs the entered project scope (datastore / project
+ *  context). Named once so the discriminant isn't restated per spec. */
+const PROJECT_SCOPE = 'project';
+/** The `command-result` output mode, named once (the leaves all share it). */
+const COMMAND_RESULT = 'command-result';
+const RAW_STREAM = 'raw-stream';
+/** Prefer the discovered project root; fall back to literal cwd; finally process.cwd(). */
+export function effectiveCwd(opts) {
+    return opts.projectContext?.projectRoot ?? opts.cwd ?? process.cwd();
+}
+// ---------------------------------------------------------------------------
+// sessions list / purge
+// ---------------------------------------------------------------------------
+function buildSessionsListSpec(ctx) {
+    return defineCommand({
+        name: 'list',
+        description: 'List stored sessions',
+        commonFlags: ['json'],
+        options: [
+            {
+                flag: '--tool',
+                value: '<name>',
+                description: 'Filter to one tool',
+                choices: ['fit', 'graph', 'sim'],
+            },
+            {
+                flag: '--limit',
+                value: '<n>',
+                description: 'Maximum sessions to return',
+                parse: parsePositiveInt,
+            },
+            {
+                flag: '--summary-only',
+                description: 'Omit heavy per-session payloads (agent friendly; showCommand and lightweight summary remain). ' +
+                    'Pairs well with --json for lean "menu" of historical results.',
+            },
+        ],
+        scope: PROJECT_SCOPE,
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            return showHistory(ctx.datastore(), {
+                tool: opts.tool,
+                limit: opts.limit,
+                summaryOnly: !!opts.summaryOnly,
+            });
+        },
+    });
+}
+function buildSessionsShowSpec(ctx) {
+    return defineCommand({
+        name: 'show',
+        description: 'Display a stored session result',
+        commonFlags: ['json'],
+        args: [{ name: 'ref', description: 'Session id, or latest with --tool' }],
+        options: [
+            {
+                flag: '--tool',
+                value: '<name>',
+                description: 'Tool for latest, or an optional id sanity check',
+                choices: ['fit', 'graph', 'sim'],
+            },
+            {
+                flag: '--filter',
+                value: '<type>',
+                description: 'Filter replayed signals (repeatable): errors-only | warnings-only | top:<n>. ' +
+                    'Composable, e.g. --filter errors-only --filter top:20. Agent ergonomics for historical results.',
+                arrayDefault: [],
+                parse: (val, prev) => [...prev, val],
+            },
+            {
+                flag: '--raw',
+                description: 'With --json: emit the inner payload (session + envelope + metadata) without the outer CommandResult wrapper. ' +
+                    'Ideal for agents that want the smallest possible response.',
+            },
+        ],
+        scope: PROJECT_SCOPE,
+        output: RAW_STREAM,
+        rawStreamReason: 'session-replay',
+        handler: async (rawOpts) => {
+            const opts = rawOpts;
+            const ref = opts._args[0];
+            const filters = normalizeFilterOption(opts.filter);
+            await executeSessionShow({
+                replayRegistry: ctx.sessionReplayRegistry,
+                ref,
+                tool: opts.tool,
+                json: opts.json,
+                filters,
+                raw: opts.raw,
+                render: ctx.render,
+                emitJson: ctx.emitJson,
+                emitRaw: ctx.emitRaw,
+                emitError: ctx.emitError,
+                setExitCode: ctx.setExitCode,
+            });
+        },
+    });
+}
+/**
+ * Normalize the repeatable `--filter` option (Commander yields a string for one
+ * occurrence, a string[] for many, undefined for none) into a uniform
+ * `string[] | undefined` for `executeSessionShow`.
+ */
+function normalizeFilterOption(filter) {
+    if (Array.isArray(filter))
+        return filter;
+    if (filter)
+        return [filter];
+    return undefined;
+}
+/**
+ * Validating coercion for `sessions list --limit <n>`.
+ *
+ * @throws {Error} When the raw value is not a positive integer.
+ */
+function parsePositiveInt(raw) {
+    const n = Number.parseInt(raw, 10);
+    if (Number.isNaN(n) || n <= 0) {
+        throw new Error(`Invalid --limit value: '${raw}'. Must be a positive integer.`);
+    }
+    return n;
+}
+/**
+ * Validating coercion for `sessions purge --older-than <days>` — identical to
+ * the former inline argParser. A named declaration (not an inline lambda) so the
+ * `@throws` contract below is documented.
+ *
+ * @throws {Error} When the raw value is not a non-negative integer.
+ */
+function parseOlderThanDays(raw) {
+    const n = Number.parseInt(raw, 10);
+    if (Number.isNaN(n) || n < 0) {
+        throw new Error(`Invalid --older-than value: '${raw}'. Must be a non-negative integer.`);
+    }
+    return n;
+}
+function buildSessionsPurgeSpec(ctx) {
+    return defineCommand({
+        name: 'purge',
+        description: 'Delete session rows from the project-local SQLite store (opensip-cli/.runtime/datastore.sqlite)',
+        commonFlags: ['json'],
+        options: [
+            {
+                flag: '--older-than',
+                value: '<days>',
+                description: 'Only delete sessions older than N days',
+                // Pure validating coercion — identical to the former inline argParser.
+                parse: parseOlderThanDays,
+            },
+            { flag: '-y, --yes', description: 'Skip confirmation prompt', default: false },
+        ],
+        scope: PROJECT_SCOPE,
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            return executeClear({
+                olderThan: opts.olderThan,
+                yes: opts.yes,
+                datastore: ctx.datastore(),
+            });
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// plugin list / add / remove / sync
+// ---------------------------------------------------------------------------
+/** The shared `--cwd <path>` option for the plugin leaves. Its description is
+ *  "Project root" (NOT the registry's "Target directory"), so it is declared as
+ *  a per-command OptionSpec rather than the `cwd` common flag — preserving the
+ *  byte-identical help text. The default resolves per-invocation (the builders
+ *  run on each `registerCliCommands` call). */
+function pluginCwdOption() {
+    return {
+        flag: '--cwd',
+        value: '<path>',
+        description: 'Project root',
+        default: process.cwd(),
+    };
+}
+function buildPluginListSpec(ctx) {
+    return defineCommand({
+        name: 'list',
+        description: 'List installed plugins',
+        commonFlags: ['json'],
+        options: [pluginCwdOption()],
+        scope: PROJECT_SCOPE,
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            // Per-run admitted-tool provenance is on the entered RunScope (stamped by
+            // the bootstrap); read it here and pass it into the pure `pluginList`.
+            return pluginList(effectiveCwd(opts), ctx.pluginLayouts, currentScope()?.toolProvenance ?? []);
+        },
+    });
+}
+function buildPluginAddSpec(ctx) {
+    return defineCommand({
+        name: 'add',
+        description: 'Install a plugin (fit/sim pack → project config; tool → user-global by default)',
+        commonFlags: ['json'],
+        options: [
+            {
+                flag: '--domain',
+                value: '<fit|sim|tool>',
+                description: 'Target domain (default: inferred; tool plugins auto-detected by marker)',
+            },
+            {
+                flag: '--project',
+                description: 'For a tool plugin, install project-local (.runtime/) instead of user-global',
+                default: false,
+            },
+            pluginCwdOption(),
+        ],
+        // Empty description: the former `.command('add <package>')` declared the
+        // positional inline with no help text, so Commander rendered no "Arguments:"
+        // block. Keeping it empty preserves the byte-identical --help.
+        args: [{ name: 'package', description: '' }],
+        scope: PROJECT_SCOPE,
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            const packageName = opts._args[0];
+            return pluginAdd(packageName, effectiveCwd(opts), opts.domain, ctx.pluginLayouts, {
+                project: opts.project,
+            });
+        },
+    });
+}
+function buildPluginRemoveSpec(ctx) {
+    return defineCommand({
+        name: 'remove',
+        description: 'Uninstall a plugin (and remove from opensip-cli.config.yml for fit/sim packs)',
+        commonFlags: ['json'],
+        options: [
+            {
+                flag: '--domain',
+                value: '<fit|sim|tool>',
+                description: 'Target domain (default: inferred from package name)',
+            },
+            {
+                flag: '--project',
+                description: 'For a tool plugin, target the project-local install instead of user-global',
+                default: false,
+            },
+            pluginCwdOption(),
+        ],
+        // Empty description — see the plugin-add note above (byte-identical --help).
+        args: [{ name: 'package', description: '' }],
+        scope: PROJECT_SCOPE,
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            const packageName = opts._args[0];
+            return pluginRemove(packageName, effectiveCwd(opts), opts.domain, ctx.pluginLayouts, {
+                project: opts.project,
+            });
+        },
+    });
+}
+function buildPluginSyncSpec(ctx) {
+    return defineCommand({
+        name: 'sync',
+        description: 'Install every plugin declared in opensip-cli.config.yml (post-clone bootstrap)',
+        commonFlags: ['json'],
+        options: [
+            { flag: '--domain', value: '<fit|sim>', description: 'Sync only one domain' },
+            pluginCwdOption(),
+        ],
+        scope: PROJECT_SCOPE,
+        output: COMMAND_RESULT,
+        handler: (rawOpts) => {
+            const opts = rawOpts;
+            return pluginSync(effectiveCwd(opts), opts.domain, ctx.pluginLayouts);
+        },
+    });
+}
+/**
+ * The action-less Commander subcommand GROUPS that legitimately cannot be a
+ * single {@link CommandSpec} — they have no action body, only sub-subcommands.
+ * This is the FINITE, NAMED set the Phase 7 `command-surface-parity` guardrail
+ * allow-lists as documented host exceptions. Every other host command IS a spec.
+ */
+export const HOST_SUBCOMMAND_GROUPS = ['sessions', 'plugin', 'tools'];
+/**
+ * Build the subcommand-group parents with their leaf specs. The mounter turns
+ * each into a raw parent `program.command(name)` plus `mountCommandSpec(parent,
+ * leaf)` for each leaf.
+ */
+export function buildHostSubcommandGroups(ctx) {
+    return [
+        {
+            name: 'sessions',
+            description: 'Manage session data',
+            leaves: [buildSessionsListSpec(ctx), buildSessionsShowSpec(ctx), buildSessionsPurgeSpec(ctx)],
+        },
+        {
+            name: 'plugin',
+            description: 'Manage project-local plugins (add, list, remove, sync)',
+            leaves: [
+                buildPluginListSpec(ctx),
+                buildPluginAddSpec(ctx),
+                buildPluginRemoveSpec(ctx),
+                buildPluginSyncSpec(ctx),
+            ],
+        },
+        {
+            name: 'tools',
+            description: 'Manage whole Tool plugins (list, validate, install, uninstall)',
+            leaves: buildToolsGroupLeaves(ctx),
+        },
+    ];
+}
+/**
+ * A no-op {@link CliCommandsContext} used purely to BUILD the group leaf specs
+ * so their `name` can be read for the completion-script sub-subcommand
+ * inventory. The handlers are never invoked here — we only inspect the static
+ * declarations — so the render/datastore/exit members are inert stubs.
+ */
+const INVENTORY_CTX = {
+    setExitCode: () => {
+        /* inert — inventory builds never dispatch a handler */
+    },
+    render: () => Promise.resolve(),
+    emitJson: () => {
+        /* inert — inventory builds never dispatch a handler */
+    },
+    emitRaw: () => {
+        /* inert — inventory builds never dispatch a handler */
+    },
+    emitError: () => {
+        /* inert — inventory builds never dispatch a handler */
+    },
+    pluginLayouts: [],
+    toolScaffolds: [],
+    // eslint-disable-next-line unicorn/no-useless-undefined -- explicit no-store sentinel matching the `datastore` thunk contract (returns `unknown`; consumers cast to `DataStore | undefined`).
+    datastore: () => undefined,
+};
+/** Build the host subcommand-group name inventory (single source for completion). */
+export function buildHostCommandInventory() {
+    const groupSubcommands = {};
+    for (const group of buildHostSubcommandGroups(INVENTORY_CTX)) {
+        groupSubcommands[group.name] = group.leaves.map((l) => l.name);
+    }
+    return { groupSubcommands };
+}
+//# sourceMappingURL=host-subcommand-groups.js.map

package/dist/commands/host-subcommand-groups.js.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * commands — orchestrator for the CLI-owned (host) subcommands.
+ *
+ * Cross-tool housekeeping that doesn't belong to any single tool:
+ *
+ *   - `init`         — scaffold opensip-cli.config.yml + example tree
+ *   - `report`       — compose + open the cross-tool HTML report
+ *   - `sessions`     — `list` / `purge`
+ *   - `configure`    — set up the OpenSIP Cloud API key
+ *   - `plugin`       — `list` / `add` / `remove` / `sync`
+ *   - `completion`   — print a shell-completion script
+ *   - `uninstall`    — remove user-level / project-local state
+ *
+ * Launch Phase 6: every host command is now a declarative
+ * `CommandSpec` mounted through the SAME `mountCommandSpec` plane the tools
+ * use (`host-command-specs.ts`). The former per-command `register-*.ts`
+ * registrars (hand-rolled `.command().option().action()` bodies) are gone —
+ * host and tool commands share ONE mounting path, so the Phase 7
+ * `command-surface-parity` guardrail sees a single uniform surface with no
+ * two-tier privilege.
+ *
+ * Tool-owned subcommands (`fit`, `sim`, `graph`, …) are mounted separately by
+ * walking the CLI-managed tool registry (`mountToolCommands`), which mounts
+ * each tool's `commandSpecs` via the same `mountCommandSpec`.
+ */
+import type { CliCommandsContext } from './shared.js';
+import type { Command } from 'commander';
+export type { CliCommandsContext } from './shared.js';
+/**
+ * Mount the CLI-owned host commands onto the supplied Commander program.
+ * Pure function — no module-level side effects, no closure over globals — so
+ * tests can register commands against a fresh `Command` instance and inspect
+ * the resulting subcommand tree.
+ */
+export declare function registerCliCommands(program: Command, ctx: CliCommandsContext): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAEnF"}

package/dist/commands/index.js

@@ -0,0 +1,36 @@
+/**
+ * commands — orchestrator for the CLI-owned (host) subcommands.
+ *
+ * Cross-tool housekeeping that doesn't belong to any single tool:
+ *
+ *   - `init`         — scaffold opensip-cli.config.yml + example tree
+ *   - `report`       — compose + open the cross-tool HTML report
+ *   - `sessions`     — `list` / `purge`
+ *   - `configure`    — set up the OpenSIP Cloud API key
+ *   - `plugin`       — `list` / `add` / `remove` / `sync`
+ *   - `completion`   — print a shell-completion script
+ *   - `uninstall`    — remove user-level / project-local state
+ *
+ * Launch Phase 6: every host command is now a declarative
+ * `CommandSpec` mounted through the SAME `mountCommandSpec` plane the tools
+ * use (`host-command-specs.ts`). The former per-command `register-*.ts`
+ * registrars (hand-rolled `.command().option().action()` bodies) are gone —
+ * host and tool commands share ONE mounting path, so the Phase 7
+ * `command-surface-parity` guardrail sees a single uniform surface with no
+ * two-tier privilege.
+ *
+ * Tool-owned subcommands (`fit`, `sim`, `graph`, …) are mounted separately by
+ * walking the CLI-managed tool registry (`mountToolCommands`), which mounts
+ * each tool's `commandSpecs` via the same `mountCommandSpec`.
+ */
+import { mountHostCommands } from './host-command-specs.js';
+/**
+ * Mount the CLI-owned host commands onto the supplied Commander program.
+ * Pure function — no module-level side effects, no closure over globals — so
+ * tests can register commands against a fresh `Command` instance and inspect
+ * the resulting subcommand tree.
+ */
+export function registerCliCommands(program, ctx) {
+    mountHostCommands(program, ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAO5D;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,GAAuB;IAC3E,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/commands/init/config-templates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Host-owned document skeleton for the `opensip init` config.
+ *
+ * Owns ONLY the document-level bytes: the YAML header, `schemaVersion`,
+ * `globalExcludes`, and the per-language `targets:` blocks. Each tool's
+ * own config block (e.g. `fitness:`) is contributed by the tool via
+ * `Tool.scaffoldConfigBlock()` (ADR-0038 Decision 2) and appended here —
+ * the host never hard-codes a tool's namespace. The example check / recipe
+ * / scenario `.mjs` bytes and the pinned check-id universe likewise live in
+ * the owning tool's `scaffold/` (relocated out of this file in ADR-0038
+ * Phases 1–2).
+ */
+import type { SupportedLanguage } from './language-detection.js';
+import type { ToolScaffold } from '../shared.js';
+export declare function generateConfig(languages: readonly SupportedLanguage[], toolScaffolds: readonly ToolScaffold[]): string;
+//# sourceMappingURL=config-templates.d.ts.map

package/dist/commands/init/config-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-templates.d.ts","sourceRoot":"","sources":["../../../src/commands/init/config-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAiFjD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,iBAAiB,EAAE,EACvC,aAAa,EAAE,SAAS,YAAY,EAAE,GACrC,MAAM,CAkBR"}

package/dist/commands/init/config-templates.js

@@ -0,0 +1,108 @@
+/**
+ * Host-owned document skeleton for the `opensip init` config.
+ *
+ * Owns ONLY the document-level bytes: the YAML header, `schemaVersion`,
+ * `globalExcludes`, and the per-language `targets:` blocks. Each tool's
+ * own config block (e.g. `fitness:`) is contributed by the tool via
+ * `Tool.scaffoldConfigBlock()` (ADR-0038 Decision 2) and appended here —
+ * the host never hard-codes a tool's namespace. The example check / recipe
+ * / scenario `.mjs` bytes and the pinned check-id universe likewise live in
+ * the owning tool's `scaffold/` (relocated out of this file in ADR-0038
+ * Phases 1–2).
+ */
+import { renderDocumentHeader } from '@opensip-cli/config';
+import { CLI_SUPPORTED_SCHEMA_VERSION } from '@opensip-cli/core';
+function targetTemplate(lang) {
+    switch (lang) {
+        case 'typescript': {
+            return {
+                name: 'typescript-source',
+                description: 'TypeScript / TSX source code',
+                languages: ['typescript'],
+                include: [
+                    'src/**/*.ts',
+                    'src/**/*.tsx',
+                    'packages/*/src/**/*.ts',
+                    'packages/*/src/**/*.tsx',
+                ],
+                exclude: [
+                    '**/*.test.ts',
+                    '**/*.test.tsx',
+                    '**/__tests__/**',
+                    '**/node_modules/**',
+                    '**/dist/**',
+                ],
+            };
+        }
+        case 'rust': {
+            return {
+                name: 'rust-source',
+                description: 'Rust source code',
+                languages: ['rust'],
+                include: ['src/**/*.rs', 'crates/**/*.rs', 'services/**/*.rs'],
+                exclude: ['**/target/**'],
+            };
+        }
+        case 'python': {
+            return {
+                name: 'python-source',
+                description: 'Python source code',
+                languages: ['python'],
+                include: ['src/**/*.py', '**/*.py'],
+                exclude: [
+                    '**/__pycache__/**',
+                    '**/.venv/**',
+                    '**/venv/**',
+                    '**/dist/**',
+                    '**/build/**',
+                    '**/*.egg-info/**',
+                ],
+            };
+        }
+        case 'go': {
+            return {
+                name: 'go-source',
+                description: 'Go source code',
+                languages: ['go'],
+                include: ['**/*.go'],
+                exclude: ['**/vendor/**', '**/_test.go'],
+            };
+        }
+        case 'java': {
+            return {
+                name: 'java-source',
+                description: 'Java source code',
+                languages: ['java'],
+                include: ['src/main/java/**/*.java', 'src/**/*.java'],
+                exclude: ['**/target/**', '**/build/**', '**/*Test.java'],
+            };
+        }
+        case 'cpp': {
+            return {
+                name: 'cpp-source',
+                description: 'C/C++ source code',
+                languages: ['cpp'],
+                include: ['src/**/*.{c,cpp,cc,h,hpp}', '**/*.{c,cpp,cc,h,hpp}'],
+                exclude: ['**/build/**', '**/cmake-build-*/**'],
+            };
+        }
+    }
+}
+export function generateConfig(languages, toolScaffolds) {
+    // The document-level skeleton (header, schemaVersion, globalExcludes, targets)
+    // is rendered by @opensip-cli/config — the package that also OWNS + validates
+    // those blocks (ADR-0023), so the scaffold cannot drift from what the
+    // composed schema accepts (asserted by a round-trip test). The CLI supplies the
+    // per-language target content; each registered tool contributes its own config
+    // block (ADR-0038 Decision 2 — fitness owns `fitness:`, sim contributes none).
+    const header = renderDocumentHeader({
+        schemaVersion: CLI_SUPPORTED_SCHEMA_VERSION,
+        targets: languages.map(targetTemplate),
+    });
+    const toolBlocks = toolScaffolds
+        .map((ts) => ts.scaffoldConfigBlock?.())
+        .filter((block) => block !== undefined)
+        .join('');
+    return `${header}\n${toolBlocks}`;
+}
+//# sourceMappingURL=config-templates.js.map

package/dist/commands/init/config-templates.js.map

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

package/dist/commands/init/file-classifier.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pre-existing file classification for `opensip init`.
+ *
+ * Walks `opensip-cli/` (skipping `.runtime/`) and tags each file as
+ * 'scaffolded', 'stale-scaffolded', or 'custom' so `--keep` / `--remove`
+ * can decide what to overwrite and what to preserve.
+ */
+import type { SupportedLanguage } from './language-detection.js';
+import type { ToolScaffold } from '../shared.js';
+import type { PreExistingFile } from '@opensip-cli/contracts';
+import type { ProjectPaths } from '@opensip-cli/core';
+/**
+ * Walk every file under `opensip-cli/` (excluding `.runtime/`, which
+ * is gitignored runtime state and not user-authored) and tag each one.
+ *
+ * Classification rules:
+ *
+ *   - 'scaffolded'        — content matches a current-template byte-for-byte.
+ *   - 'stale-scaffolded'  — file shape matches a previous-language scaffold:
+ *                           filename `example-check-<lang>.mjs` for <lang>
+ *                           NOT in the current detection set, OR the file
+ *                           carries a pinned EXAMPLE_CHECK_IDS UUID for a
+ *                           language not in the current set.
+ *   - 'custom'            — anything else (user-authored).
+ *
+ * The walk is bounded to the `opensip-cli/` subtree (kilobytes in
+ * practice). The `.runtime/` subdir is skipped so caches/logs/sessions
+ * don't pollute the file list.
+ *
+ * Note on hash-based scaffolded detection: a scaffolded file that has
+ * been line-ending normalized (CRLF↔LF) or stripped of a trailing
+ * newline by an editor will not byte-for-byte match the template. In
+ * that case it falls back to 'custom' or 'stale-scaffolded' (when the
+ * UUID still matches but content drifted). The UUID-based fallback
+ * catches the common "stale language" case; cosmetic drift on a
+ * current-language file is treated as custom — which is the safer
+ * outcome (won't silently overwrite).
+ */
+export declare function classifyFiles(paths: ProjectPaths, currentLanguages: readonly SupportedLanguage[], toolScaffolds: readonly ToolScaffold[]): PreExistingFile[];
+//# sourceMappingURL=file-classifier.d.ts.map

package/dist/commands/init/file-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-classifier.d.ts","sourceRoot":"","sources":["../../../src/commands/init/file-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA8BtD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,gBAAgB,EAAE,SAAS,iBAAiB,EAAE,EAC9C,aAAa,EAAE,SAAS,YAAY,EAAE,GACrC,eAAe,EAAE,CA0DnB"}