opensip-cli 0.1.0

package/dist/commands/init/file-classifier.js

@@ -0,0 +1,155 @@
+/**
+ * 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 { createHash } from 'node:crypto';
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { basename as pathBasename, join } from 'node:path';
+import { ALL_LANGUAGES } from './language-detection.js';
+/**
+ * Build the full set of scaffold templates that init would write for the given
+ * language set — registry-driven (ADR-0038): each tool's `scaffoldExamples` over
+ * the current languages, mapped to `userPluginDir(domain, file.kind)/filename`.
+ * Same bytes as before; the classifier detects "scaffolded" files via SHA-256.
+ */
+function buildScaffoldTemplates(paths, languages, toolScaffolds) {
+    const templates = new Map();
+    for (const ts of toolScaffolds) {
+        if (!ts.scaffoldExamples)
+            continue;
+        for (const file of ts.scaffoldExamples({ languages })) {
+            templates.set(join(paths.userPluginDir(ts.layout.domain, file.kind), file.filename), file.content);
+        }
+    }
+    return templates;
+}
+function sha256(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * 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 function classifyFiles(paths, currentLanguages, toolScaffolds) {
+    if (!existsSync(paths.userSourceDir))
+        return [];
+    const templates = buildScaffoldTemplates(paths, currentLanguages, toolScaffolds);
+    const templateHashes = new Map();
+    for (const [absPath, body] of templates) {
+        templateHashes.set(absPath, sha256(body));
+    }
+    const currentLangSet = new Set(currentLanguages);
+    // Stale-id detection (ADR-0038): the COMPLETE id universe each tool owns
+    // (`stableExampleIds`), minus the ids the CURRENT languages scaffold. A file
+    // carrying a complete-but-not-current id is a stale scaffold for a config the
+    // project no longer uses; current-config ids are excluded so an edited
+    // current-language example (no content-hash match) stays `custom`.
+    const completeIds = new Set(toolScaffolds.flatMap((ts) => ts.stableExampleIds?.() ?? []));
+    const currentIds = new Set(toolScaffolds.flatMap((ts) => (ts.scaffoldExamples?.({ languages: currentLanguages }) ?? []).map((f) => f.stableId)));
+    const staleIds = [...completeIds].filter((id) => !currentIds.has(id));
+    const out = [];
+    // Walk the dir, skipping `.runtime/`.
+    const visit = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            // @fitness-ignore-next-line error-handling-quality -- directory walk probe: an unreadable directory means "no entries to classify here", same as a genuinely empty dir; failure IS the signal.
+            return;
+        }
+        for (const name of entries) {
+            const full = join(dir, name);
+            // Skip runtime state (gitignored, tool-managed).
+            if (full === paths.runtimeDir)
+                continue;
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                visit(full);
+                continue;
+            }
+            if (!st.isFile())
+                continue;
+            out.push(classifyOneFile(full, templateHashes, currentLangSet, staleIds));
+        }
+    };
+    visit(paths.userSourceDir);
+    // Stable order — relative path ascending — so callers can render a
+    // deterministic list and tests can assert without sort gymnastics.
+    out.sort((a, b) => a.path.localeCompare(b.path));
+    return out;
+}
+const STALE_FILENAME_PATTERN = /^example-check-([a-z+]+)\.mjs$/;
+function classifyOneFile(absPath, templateHashes, currentLangSet, staleIds) {
+    let content;
+    try {
+        content = readFileSync(absPath, 'utf8');
+    }
+    catch {
+        // Unreadable: surface as custom so we err on the side of preservation.
+        return { path: absPath, classification: 'custom' };
+    }
+    // 1) Content-hash match against current-template set.
+    const hash = sha256(content);
+    if (templateHashes.get(absPath) === hash) {
+        return { path: absPath, classification: 'scaffolded' };
+    }
+    // 2) Stale-by-filename: example-check-<lang>.mjs for <lang> not in
+    //    current set.
+    // Use node:path basename so the separator extraction works on Windows.
+    // A hard-coded '/' would leave `basename` equal to the whole absolute
+    // Windows path (`lastIndexOf('/')` returns -1), and STALE_FILENAME_PATTERN
+    // would never match — silently misclassifying every stale-scaffolded
+    // file as 'custom' and breaking `--keep` semantics on Windows.
+    const basename = pathBasename(absPath);
+    const filenameMatch = STALE_FILENAME_PATTERN.exec(basename);
+    if (filenameMatch) {
+        const fileLang = filenameMatch[1];
+        if (fileLang &&
+            !currentLangSet.has(fileLang) &&
+            ALL_LANGUAGES.includes(fileLang)) {
+            return { path: absPath, classification: 'stale-scaffolded' };
+        }
+    }
+    // 3) Stale-by-pinned-id: any of the aggregated stale ids (the complete tool id
+    //    universe minus the current-config ids) embedded in the file.
+    for (const id of staleIds) {
+        if (content.includes(id)) {
+            return { path: absPath, classification: 'stale-scaffolded' };
+        }
+    }
+    return { path: absPath, classification: 'custom' };
+}
+//# sourceMappingURL=file-classifier.js.map

package/dist/commands/init/file-classifier.js.map

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

package/dist/commands/init/language-detection.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Language detection for `opensip init`.
+ *
+ * Inspects the cwd for well-known language markers (Cargo.toml,
+ * pyproject.toml, go.mod, pom.xml/build.gradle, CMakeLists.txt,
+ * tsconfig.json/package.json) and returns the unique set of detected
+ * languages. Also parses the `--language <comma-separated>` flag that
+ * overrides detection.
+ */
+export type SupportedLanguage = 'typescript' | 'rust' | 'python' | 'go' | 'java' | 'cpp';
+export declare const ALL_LANGUAGES: readonly SupportedLanguage[];
+/**
+ * Inspect the cwd for language markers. Returns the unique set of
+ * detected languages. TypeScript is detected only when there's a
+ * `tsconfig.json` (or a `package.json` with no other marker
+ * present — fallback for plain JS/TS projects).
+ */
+export declare function detectLanguages(cwd: string): SupportedLanguage[];
+/**
+ * Parse the `--language <comma-separated>` argv string into a list of
+ * known languages. Throws on unknown entries — the CLI surfaces it as
+ * an exit-2 configuration error.
+ *
+ * @throws {Error} When `raw` contains a token not present in `ALL_LANGUAGES`.
+ */
+export declare function parseLanguageFlag(raw: string): SupportedLanguage[];
+export type LanguageResolution = {
+    ok: true;
+    languages: SupportedLanguage[];
+} | {
+    ok: false;
+    error: {
+        detected: SupportedLanguage[];
+        message: string;
+    };
+};
+/**
+ * Resolve the language set for an init run: either parse the explicit
+ * --language flag, or fall back to filesystem detection. Returns an
+ * error variant when no markers are found, or when multiple languages
+ * are detected without --language to disambiguate.
+ */
+export declare function resolveLanguages(cwd: string, languageFlag: readonly string[] | undefined): LanguageResolution;
+//# sourceMappingURL=language-detection.d.ts.map

package/dist/commands/init/language-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detection.d.ts","sourceRoot":"","sources":["../../../src/commands/init/language-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzF,eAAO,MAAM,aAAa,EAAE,SAAS,iBAAiB,EAOrD,CAAC;AAmBF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAiBhE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAmBlE;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAC1C,kBAAkB,CAuCpB"}

package/dist/commands/init/language-detection.js

@@ -0,0 +1,124 @@
+/**
+ * Language detection for `opensip init`.
+ *
+ * Inspects the cwd for well-known language markers (Cargo.toml,
+ * pyproject.toml, go.mod, pom.xml/build.gradle, CMakeLists.txt,
+ * tsconfig.json/package.json) and returns the unique set of detected
+ * languages. Also parses the `--language <comma-separated>` flag that
+ * overrides detection.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+export const ALL_LANGUAGES = [
+    'typescript',
+    'rust',
+    'python',
+    'go',
+    'java',
+    'cpp',
+];
+const ALL_LANGUAGES_SET = new Set(ALL_LANGUAGES);
+const MARKERS = [
+    { language: 'rust', file: 'Cargo.toml', description: 'Rust workspace' },
+    { language: 'python', file: 'pyproject.toml', description: 'Python project' },
+    { language: 'python', file: 'setup.py', description: 'Python project (setup.py)' },
+    { language: 'go', file: 'go.mod', description: 'Go module' },
+    { language: 'java', file: 'pom.xml', description: 'Maven project' },
+    { language: 'java', file: 'build.gradle', description: 'Gradle project' },
+    { language: 'cpp', file: 'CMakeLists.txt', description: 'CMake project' },
+];
+/**
+ * Inspect the cwd for language markers. Returns the unique set of
+ * detected languages. TypeScript is detected only when there's a
+ * `tsconfig.json` (or a `package.json` with no other marker
+ * present — fallback for plain JS/TS projects).
+ */
+export function detectLanguages(cwd) {
+    const detected = new Set();
+    for (const marker of MARKERS) {
+        if (existsSync(join(cwd, marker.file)))
+            detected.add(marker.language);
+    }
+    // TypeScript: tsconfig.json is the strong signal. package.json alone
+    // is ambiguous — a Rust project might have a docs site with one — but
+    // ONLY when no other marker is present, treat it as a TS project.
+    const hasTsconfig = existsSync(join(cwd, 'tsconfig.json'));
+    const hasPackageJson = existsSync(join(cwd, 'package.json'));
+    if (hasTsconfig || (hasPackageJson && detected.size === 0)) {
+        detected.add('typescript');
+    }
+    return [...detected];
+}
+/**
+ * Parse the `--language <comma-separated>` argv string into a list of
+ * known languages. Throws on unknown entries — the CLI surfaces it as
+ * an exit-2 configuration error.
+ *
+ * @throws {Error} When `raw` contains a token not present in `ALL_LANGUAGES`.
+ */
+export function parseLanguageFlag(raw) {
+    const out = [];
+    const seen = new Set();
+    for (const part of raw.split(',')) {
+        const trimmed = part.trim().toLowerCase();
+        if (trimmed.length === 0)
+            continue;
+        if (seen.has(trimmed))
+            continue;
+        if (!ALL_LANGUAGES_SET.has(trimmed)) {
+            throw new Error(`Unknown language '${trimmed}'. Expected one of: ${ALL_LANGUAGES.join(', ')}`);
+        }
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    if (out.length === 0) {
+        throw new Error('--language received an empty list');
+    }
+    return out;
+}
+/**
+ * Resolve the language set for an init run: either parse the explicit
+ * --language flag, or fall back to filesystem detection. Returns an
+ * error variant when no markers are found, or when multiple languages
+ * are detected without --language to disambiguate.
+ */
+export function resolveLanguages(cwd, languageFlag) {
+    if (languageFlag && languageFlag.length > 0) {
+        try {
+            // The flag is an accumulator (`--language ts --language rust`) whose
+            // elements may also be comma-separated (`--language ts,rust`). Join into
+            // one canonical comma-list and delegate to the established parser, which
+            // splits, trims, dedupes, and validates.
+            return { ok: true, languages: parseLanguageFlag(languageFlag.join(',')) };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return { ok: false, error: { detected: [], message: msg } };
+        }
+    }
+    const detected = detectLanguages(cwd);
+    if (detected.length === 0) {
+        return {
+            ok: false,
+            error: {
+                detected: [],
+                message: 'No language markers found. Specify with: ' +
+                    'opensip init --language <typescript|rust|python|go|java|cpp> ' +
+                    '(comma-separated for polyglot projects).',
+            },
+        };
+    }
+    if (detected.length > 1) {
+        return {
+            ok: false,
+            error: {
+                detected,
+                message: `Detected multiple languages: ${detected.join(', ')}. ` +
+                    `Pass --language <comma-separated-list> to choose. ` +
+                    `Example: opensip init --language ${detected.join(',')}`,
+            },
+        };
+    }
+    return { ok: true, languages: detected };
+}
+//# sourceMappingURL=language-detection.js.map

package/dist/commands/init/language-detection.js.map

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

package/dist/commands/init/scaffold-writer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Disk-write phase for `opensip init`.
+ *
+ * Writes the config + example files, optionally preserving pre-existing
+ * custom/stale-scaffolded files (`--keep`) or wiping the user-source
+ * dir first (`--remove`). Also patches `.gitignore` to exclude the
+ * runtime state subtree.
+ */
+import type { SupportedLanguage } from './language-detection.js';
+import type { WorkingDirState } from './state-machine.js';
+import type { ToolScaffold } from '../shared.js';
+import type { InitResult, PreExistingFile } from '@opensip-cli/contracts';
+import type { ProjectPaths } from '@opensip-cli/core';
+export interface ScaffoldRunInputs {
+    readonly paths: ProjectPaths;
+    readonly languages: SupportedLanguage[];
+    readonly cwd: string;
+    readonly state: WorkingDirState;
+    readonly preExistingFiles: readonly PreExistingFile[];
+    readonly removeFirst: boolean;
+    readonly keepCustom: boolean;
+    /** Per-tool scaffold contributions (ADR-0038) — the directory layout + example bytes. */
+    readonly toolScaffolds: readonly ToolScaffold[];
+}
+export declare function runScaffold(inputs: ScaffoldRunInputs, baseResult: Pick<InitResult, 'type' | 'path' | 'cwd' | 'configFilename'>): InitResult;
+//# sourceMappingURL=scaffold-writer.d.ts.map

package/dist/commands/init/scaffold-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-writer.d.ts","sourceRoot":"","sources":["../../../src/commands/init/scaffold-writer.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,mBAAmB,CAAC;AA2FvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAC;CACjD;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,gBAAgB,CAAC,GACvE,UAAU,CAuCZ"}

package/dist/commands/init/scaffold-writer.js

@@ -0,0 +1,102 @@
+// @fitness-ignore-file unbounded-memory -- reads scaffold template files shipped with the CLI; bounded by the package's own embedded examples
+/**
+ * Disk-write phase for `opensip init`.
+ *
+ * Writes the config + example files, optionally preserving pre-existing
+ * custom/stale-scaffolded files (`--keep`) or wiping the user-source
+ * dir first (`--remove`). Also patches `.gitignore` to exclude the
+ * runtime state subtree.
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { generateConfig } from './config-templates.js';
+const GITIGNORE_LINE = 'opensip-cli/.runtime/';
+function ensureGitignore(cwd) {
+    const path = join(cwd, '.gitignore');
+    if (!existsSync(path)) {
+        writeFileSync(path, `${GITIGNORE_LINE}\n`, 'utf8');
+        return true;
+    }
+    const content = readFileSync(path, 'utf8');
+    // @fitness-ignore-next-line silent-early-returns -- idempotent "did I modify?" return: boolean IS the function's contract (caller dispatches on "already present" vs "I appended")
+    if (content.split('\n').some((line) => line.trim() === GITIGNORE_LINE)) {
+        return false; // already present, idempotent
+    }
+    const sep = content.endsWith('\n') ? '' : '\n';
+    writeFileSync(path, `${content}${sep}\n# opensip-cli runtime state\n${GITIGNORE_LINE}\n`, 'utf8');
+    return true;
+}
+/**
+ * Write `content` to `filePath` according to the scaffold rules:
+ *   - keepCustom = false → always overwrite (or create) the file.
+ *   - keepCustom = true  → preserve any pre-existing file we classified
+ *                          as 'custom' or 'stale-scaffolded'; overwrite
+ *                          'scaffolded' files (and create missing ones).
+ */
+function writeScaffoldedFile(filePath, content, keepCustom, preExistingByPath, createdFiles) {
+    if (keepCustom) {
+        const existing = preExistingByPath.get(filePath);
+        // Preserve user content. Stale-scaffolded is also preserved — the
+        // user may have been working with it; we surface it but don't
+        // overwrite.
+        if (existing &&
+            (existing.classification === 'custom' || existing.classification === 'stale-scaffolded')) {
+            return;
+        }
+    }
+    writeFileSync(filePath, content, 'utf8');
+    createdFiles.push(filePath);
+}
+/**
+ * ADR-0038: generic, registry-driven scaffold. For each registered tool's
+ * contribution: `mkdir` every `userSubdirs` kind under its `pluginLayout.domain`,
+ * then write each `ScaffoldFile` the tool's `scaffoldExamples(ctx)` returns under
+ * `userPluginDir(domain, file.kind)/file.filename`. No fit/sim/checks/recipes
+ * literals — the directory layout comes from each tool's `pluginLayout`, the
+ * example bytes from the tool (ADR-0009 corollary 1).
+ */
+function scaffoldToolExamples(paths, toolScaffolds, ctx, options, createdFiles) {
+    for (const ts of toolScaffolds) {
+        if (!ts.scaffoldExamples)
+            continue;
+        for (const kind of ts.layout.userSubdirs) {
+            mkdirSync(paths.userPluginDir(ts.layout.domain, kind), { recursive: true });
+        }
+        for (const file of ts.scaffoldExamples(ctx)) {
+            writeScaffoldedFile(join(paths.userPluginDir(ts.layout.domain, file.kind), file.filename), file.content, options.keepCustom, options.preExistingByPath, createdFiles);
+        }
+    }
+}
+export function runScaffold(inputs, baseResult) {
+    const { paths, languages, cwd, state, preExistingFiles, removeFirst, keepCustom, toolScaffolds } = inputs;
+    // --remove: blow away the user-source dir before scaffolding. The
+    // config file is always rewritten below regardless.
+    if (removeFirst && existsSync(paths.userSourceDir)) {
+        rmSync(paths.userSourceDir, { recursive: true, force: true });
+    }
+    const createdFiles = [];
+    // Always rewrite the config — its content is a function of the
+    // selected languages, and a re-init with new --language values must
+    // refresh it. (The legacy code rewrote it unconditionally on --force
+    // too; we keep that semantics.)
+    writeFileSync(paths.configFile, generateConfig(languages, toolScaffolds), 'utf8');
+    createdFiles.push(paths.configFile);
+    // After --remove the dir is gone, so nothing pre-existed; pass an
+    // empty map so writeScaffoldedFile creates everything fresh.
+    const preExistingByPath = removeFirst
+        ? new Map()
+        : new Map(preExistingFiles.map((f) => [f.path, f]));
+    const ctx = { languages };
+    scaffoldToolExamples(paths, toolScaffolds, ctx, { keepCustom, preExistingByPath }, createdFiles);
+    const gitignoreUpdated = ensureGitignore(cwd);
+    return {
+        ...baseResult,
+        created: true,
+        state,
+        languages,
+        createdFiles,
+        gitignoreUpdated,
+        preExistingFiles: state === 'pristine' ? [] : preExistingFiles,
+    };
+}
+//# sourceMappingURL=scaffold-writer.js.map

package/dist/commands/init/scaffold-writer.js.map

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

package/dist/commands/init/state-machine.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Working-directory state classification for `opensip init`.
+ *
+ * Decides one of four states (pristine / fully-initialized /
+ * partial-config-only / partial-dir-only) based on whether the config
+ * file and the user-source dir exist, and renders the partial-state
+ * refusal message + the "discovered inside existing project" message.
+ */
+import type { InitResult, PreExistingFile } from '@opensip-cli/contracts';
+import type { ProjectPaths } from '@opensip-cli/core';
+export type WorkingDirState = NonNullable<InitResult['state']>;
+/**
+ * Classify the working directory into one of four states based on the
+ * presence of the config file and the `opensip-cli/` directory.
+ *
+ * The dir-presence check ignores `opensip-cli/.runtime/` — that
+ * subtree is tool-managed (logs, sessions, caches, plugin installs)
+ * and the CLI's `preAction` hook creates `.runtime/logs/` before any
+ * subcommand runs. Treating a runtime-only dir as a "partial-dir"
+ * would misclassify a pristine project the moment the bootstrap hook
+ * touches the disk. User-authored content lives under
+ * `opensip-cli/{fit,sim}/`; only those count as "the dir is present".
+ */
+export declare function classifyWorkingDir(paths: ProjectPaths): WorkingDirState;
+export declare function buildPartialStateMessage(state: WorkingDirState, preExistingFiles: readonly PreExistingFile[], cwd: string): string;
+/**
+ * Build the "✗ This directory is already inside an OpenSIP CLI project"
+ * refusal message. Same string is embedded in the InitResult.insideExistingProject
+ * for --json consumers and rendered by InitFeedback for human-readable output.
+ */
+export declare function formatInsideExistingProjectMessage(discoveredRoot: string): string;
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/commands/init/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../../src/commands/init/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CAOvE;AAoBD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,gBAAgB,EAAE,SAAS,eAAe,EAAE,EAC5C,GAAG,EAAE,MAAM,GACV,MAAM,CAmCR;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAkBjF"}

package/dist/commands/init/state-machine.js

@@ -0,0 +1,105 @@
+/**
+ * Working-directory state classification for `opensip init`.
+ *
+ * Decides one of four states (pristine / fully-initialized /
+ * partial-config-only / partial-dir-only) based on whether the config
+ * file and the user-source dir exist, and renders the partial-state
+ * refusal message + the "discovered inside existing project" message.
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { relative } from 'node:path';
+/**
+ * Classify the working directory into one of four states based on the
+ * presence of the config file and the `opensip-cli/` directory.
+ *
+ * The dir-presence check ignores `opensip-cli/.runtime/` — that
+ * subtree is tool-managed (logs, sessions, caches, plugin installs)
+ * and the CLI's `preAction` hook creates `.runtime/logs/` before any
+ * subcommand runs. Treating a runtime-only dir as a "partial-dir"
+ * would misclassify a pristine project the moment the bootstrap hook
+ * touches the disk. User-authored content lives under
+ * `opensip-cli/{fit,sim}/`; only those count as "the dir is present".
+ */
+export function classifyWorkingDir(paths) {
+    const hasConfig = existsSync(paths.configFile);
+    const hasDir = userSourceDirHasUserContent(paths);
+    if (!hasConfig && !hasDir)
+        return 'pristine';
+    if (hasConfig && hasDir)
+        return 'fully-initialized';
+    if (hasConfig)
+        return 'partial-config-only';
+    return 'partial-dir-only';
+}
+function userSourceDirHasUserContent(paths) {
+    if (!existsSync(paths.userSourceDir))
+        return false;
+    let entries;
+    try {
+        entries = readdirSync(paths.userSourceDir);
+    }
+    catch {
+        // @fitness-ignore-next-line error-handling-quality -- directory probe: an unreadable userSourceDir means "no user content present", treated identically to an empty dir; failure IS the signal.
+        return false;
+    }
+    // Anything other than `.runtime/` (tool-managed) counts as user content.
+    return entries.some((name) => name !== '.runtime');
+}
+function relativize(absPath, cwd) {
+    const rel = relative(cwd, absPath);
+    return rel === '' ? absPath : rel;
+}
+export function buildPartialStateMessage(state, preExistingFiles, cwd) {
+    const lines = [];
+    switch (state) {
+        case 'fully-initialized': {
+            lines.push('OpenSIP CLI is already initialized in this directory.');
+            break;
+        }
+        case 'partial-config-only': {
+            lines.push('opensip-cli.config.yml exists but opensip-cli/ does not.');
+            break;
+        }
+        case 'partial-dir-only': {
+            lines.push('opensip-cli/ exists but opensip-cli.config.yml does not.');
+            break;
+        }
+        case 'pristine': {
+            // Should not happen in this code path — pristine never errors.
+            return 'Unexpected pristine state.';
+        }
+    }
+    if (preExistingFiles.length > 0) {
+        lines.push('', `Found ${String(preExistingFiles.length)} file(s) under opensip-cli/:`);
+        for (const f of preExistingFiles) {
+            lines.push(`  ${relativize(f.path, cwd)}  (${f.classification})`);
+        }
+    }
+    lines.push('', 'Choose one:', '  opensip init --keep    Re-scaffold examples; preserve custom files.', '  opensip init --remove  Delete opensip-cli/ and scaffold fresh.');
+    return lines.join('\n');
+}
+/**
+ * Build the "✗ This directory is already inside an OpenSIP CLI project"
+ * refusal message. Same string is embedded in the InitResult.insideExistingProject
+ * for --json consumers and rendered by InitFeedback for human-readable output.
+ */
+export function formatInsideExistingProjectMessage(discoveredRoot) {
+    return [
+        `✗ This directory is already inside an OpenSIP CLI project:`,
+        `    ${discoveredRoot}`,
+        `    (config: opensip-cli.config.yml)`,
+        ``,
+        `  What did you want to do?`,
+        ``,
+        `    • Re-scaffold examples, keep your custom files:`,
+        `        opensip init --keep --cwd ${discoveredRoot}`,
+        ``,
+        `    • Reset the existing project (delete everything, start over):`,
+        `        opensip init --remove --cwd ${discoveredRoot}`,
+        ``,
+        `    • Create a NEW separate project here (rare — only for`,
+        `      truly independent sub-projects in a monorepo):`,
+        `        opensip init --cwd .`,
+    ].join('\n');
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/commands/init/state-machine.js.map

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