@jeger-ai/opengantry 1.0.0

package/dist/cli/lib/init-compose-arch-pointer.js

@@ -0,0 +1,64 @@
+import { REL_ARCHITECTURE_DISCOVERY_SKILL } from "./constants.js";
+const DEFAULT_FILE_LOCATION = "docs/ARCHITECTURE.md";
+const DEFAULT_DIRECTORY_LOCATION = "docs/architecture";
+export function defaultArchitectureLocation(kind) {
+    switch (kind) {
+        case "file":
+            return DEFAULT_FILE_LOCATION;
+        case "directory":
+            return DEFAULT_DIRECTORY_LOCATION;
+        case "external":
+            return "https://example.com/architecture";
+        default:
+            return "";
+    }
+}
+export function composeArchitecturePointer(profile) {
+    const kind = profile.architectureSource;
+    const location = (profile.architectureLocation ?? defaultArchitectureLocation(kind)).trim();
+    if (kind === "unset") {
+        return {
+            schema_version: "0.1.0",
+            kind: "unset",
+            location: "",
+            read_hint: "Architecture source not selected. Do NOT invent layer layout, module boundaries, or dependency rules. Read .gitagent/teacher/ARCHITECTURE-DISCOVERY.md and ask the user structured questions before any application code changes.",
+            discovery: { skill: REL_ARCHITECTURE_DISCOVERY_SKILL },
+        };
+    }
+    if (kind === "file") {
+        return {
+            schema_version: "0.1.0",
+            kind: "file",
+            location,
+            read_hint: "Read this markdown file for repository layout and boundaries. If content is still the init stub, treat as unset and follow ARCHITECTURE-DISCOVERY.md before implementing.",
+            discovery: { skill: REL_ARCHITECTURE_DISCOVERY_SKILL },
+        };
+    }
+    if (kind === "directory") {
+        return {
+            schema_version: "0.1.0",
+            kind: "directory",
+            location,
+            read_hint: "List this folder, read README or index first, then layer notes. If empty or placeholder-only, follow ARCHITECTURE-DISCOVERY.md before implementing.",
+            discovery: { skill: REL_ARCHITECTURE_DISCOVERY_SKILL },
+        };
+    }
+    return {
+        schema_version: "0.1.0",
+        kind: "external",
+        location,
+        read_hint: "Fetch architecture docs from this external source. If access.required, read ARCHITECTURE-ACCESS.md first. If unreachable or empty, follow ARCHITECTURE-DISCOVERY.md — do not assume layout.",
+        discovery: { skill: REL_ARCHITECTURE_DISCOVERY_SKILL },
+        access: profile.architectureAccessRequired
+            ? {
+                required: true,
+                credential_slot: profile.architectureCredentialSlot,
+                auth_hint: profile.architectureAuthHint,
+            }
+            : undefined,
+    };
+}
+export function serializeArchitecturePointer(pointer) {
+    return `${JSON.stringify(pointer, null, 2)}\n`;
+}
+//# sourceMappingURL=init-compose-arch-pointer.js.map

package/dist/cli/lib/init-compose-arch-pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-compose-arch-pointer.js","sourceRoot":"","sources":["../../../src/cli/lib/init-compose-arch-pointer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AAGlE,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AACrD,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAEvD,MAAM,UAAU,2BAA2B,CAAC,IAA4B;IACtE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,qBAAqB,CAAC;QAC/B,KAAK,WAAW;YACd,OAAO,0BAA0B,CAAC;QACpC,KAAK,UAAU;YACb,OAAO,kCAAkC,CAAC;QAC5C;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAoB;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC;IACxC,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,oBAAoB,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE5F,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO;YACL,cAAc,EAAE,OAAO;YACvB,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,EAAE;YACZ,SAAS,EACP,mOAAmO;YACrO,SAAS,EAAE,EAAE,KAAK,EAAE,gCAAgC,EAAE;SACvD,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO;YACL,cAAc,EAAE,OAAO;YACvB,IAAI,EAAE,MAAM;YACZ,QAAQ;YACR,SAAS,EACP,2KAA2K;YAC7K,SAAS,EAAE,EAAE,KAAK,EAAE,gCAAgC,EAAE;SACvD,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO;YACL,cAAc,EAAE,OAAO;YACvB,IAAI,EAAE,WAAW;YACjB,QAAQ;YACR,SAAS,EACP,qJAAqJ;YACvJ,SAAS,EAAE,EAAE,KAAK,EAAE,gCAAgC,EAAE;SACvD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,cAAc,EAAE,OAAO;QACvB,IAAI,EAAE,UAAU;QAChB,QAAQ;QACR,SAAS,EACP,6LAA6L;QAC/L,SAAS,EAAE,EAAE,KAAK,EAAE,gCAAgC,EAAE;QACtD,MAAM,EAAE,OAAO,CAAC,0BAA0B;YACxC,CAAC,CAAC;gBACE,QAAQ,EAAE,IAAI;gBACd,eAAe,EAAE,OAAO,CAAC,0BAA0B;gBACnD,SAAS,EAAE,OAAO,CAAC,oBAAoB;aACxC;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAA4B;IACvE,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC"}

package/dist/cli/lib/init-compose-doc.d.ts

@@ -0,0 +1,5 @@
+import { type IntegrationCompatManifest } from "./integration-compat.js";
+import type { InitProfile } from "./init-profile.js";
+export declare function composeIntegrationsDoc(profile: InitProfile, templatesRoot: string, compat?: IntegrationCompatManifest): string;
+export declare function recipeFilesExist(templatesRoot: string, compat?: IntegrationCompatManifest): void;
+//# sourceMappingURL=init-compose-doc.d.ts.map

package/dist/cli/lib/init-compose-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-compose-doc.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/init-compose-doc.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQrD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,yBAAyB,GACjC,MAAM,CAaR;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAWhG"}

package/dist/cli/lib/init-compose-doc.js

@@ -0,0 +1,37 @@
+import fs from "node:fs";
+import path from "node:path";
+import { INTEGRATION_IDE_KEYS, loadIntegrationCompat, } from "./integration-compat.js";
+function readRecipe(templatesRoot, recipeFile) {
+    const p = path.join(templatesRoot, "integrations/recipes", recipeFile);
+    if (!fs.existsSync(p))
+        throw new Error(`init compose: missing recipe ${recipeFile}`);
+    return fs.readFileSync(p, "utf8").trimEnd();
+}
+export function composeIntegrationsDoc(profile, templatesRoot, compat) {
+    const manifest = compat ?? loadIntegrationCompat(templatesRoot);
+    const parts = [];
+    parts.push(readRecipe(templatesRoot, "_preamble.md"));
+    for (const key of INTEGRATION_IDE_KEYS) {
+        if (!profile.ides.includes(key))
+            continue;
+        const entry = manifest.integrations[key];
+        parts.push(readRecipe(templatesRoot, entry.recipe_file));
+    }
+    parts.push(readRecipe(templatesRoot, "_footer.md"));
+    return `${parts.join("\n\n")}\n`;
+}
+export function recipeFilesExist(templatesRoot, compat) {
+    const manifest = compat ?? loadIntegrationCompat(templatesRoot);
+    for (const key of INTEGRATION_IDE_KEYS) {
+        const recipe = manifest.integrations[key].recipe_file;
+        const p = path.join(templatesRoot, "integrations/recipes", recipe);
+        if (!fs.existsSync(p))
+            throw new Error(`init compose: missing recipe file for ${key}: ${recipe}`);
+    }
+    for (const fixed of ["_preamble.md", "_footer.md"]) {
+        const p = path.join(templatesRoot, "integrations/recipes", fixed);
+        if (!fs.existsSync(p))
+            throw new Error(`init compose: missing ${fixed}`);
+    }
+}
+//# sourceMappingURL=init-compose-doc.js.map

package/dist/cli/lib/init-compose-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-compose-doc.js","sourceRoot":"","sources":["../../../src/cli/lib/init-compose-doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,yBAAyB,CAAC;AAGjC,SAAS,UAAU,CAAC,aAAqB,EAAE,UAAkB;IAC3D,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,sBAAsB,EAAE,UAAU,CAAC,CAAC;IACvE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;IACrF,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAoB,EACpB,aAAqB,EACrB,MAAkC;IAElC,MAAM,QAAQ,GAAG,MAAM,IAAI,qBAAqB,CAAC,aAAa,CAAC,CAAC;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IAEtD,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,aAAqB,EAAE,MAAkC;IACxF,MAAM,QAAQ,GAAG,MAAM,IAAI,qBAAqB,CAAC,aAAa,CAAC,CAAC;IAChE,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QACtD,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAC;QACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,KAAK,MAAM,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAClE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/cli/lib/init-interactive.d.ts

@@ -0,0 +1,8 @@
+import { type InitProfile } from "./init-profile.js";
+export declare function runInitInteractiveWizard(repoRoot: string, templatesRoot: string, partial: Partial<InitProfile>): Promise<InitProfile | null>;
+export declare function canPromptInitOverwrite(options: {
+    dryRun?: boolean;
+    force?: boolean;
+}): boolean;
+export declare function promptOverwriteManagedAssets(conflicts: string[]): Promise<boolean | null>;
+//# sourceMappingURL=init-interactive.d.ts.map

package/dist/cli/lib/init-interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-interactive.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/init-interactive.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAC;AAkK3B,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAyC7B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAO9F;AAED,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAc/F"}

package/dist/cli/lib/init-interactive.js

@@ -0,0 +1,195 @@
+import * as p from "@clack/prompts";
+import { INTEGRATION_IDE_KEYS, integrationWizardLabel, loadIntegrationCompat, } from "./integration-compat.js";
+import { defaultInitProfile, mergeInitProfile, } from "./init-profile.js";
+import { defaultArchitectureLocation } from "./init-compose-arch-pointer.js";
+function wizardCancelled(value) {
+    return p.isCancel(value);
+}
+async function promptInitIntegrations(repoRoot, partial, base, compat) {
+    const confirmRoot = await p.confirm({
+        message: `Initialize OpenGantry in ${repoRoot}?`,
+        initialValue: true,
+    });
+    if (wizardCancelled(confirmRoot) || !confirmRoot) {
+        p.cancel("init cancelled");
+        return null;
+    }
+    const ideOptions = INTEGRATION_IDE_KEYS.map((value) => ({
+        value,
+        label: integrationWizardLabel(compat.integrations[value]),
+    }));
+    const selectedIdes = await p.multiselect({
+        message: "Agent / IDE integrations to scaffold",
+        options: ideOptions,
+        initialValues: partial.ides ?? base.ides,
+        required: true,
+    });
+    if (wizardCancelled(selectedIdes)) {
+        p.cancel("init cancelled");
+        return null;
+    }
+    const docPath = await p.text({
+        message: "Integrations documentation path (repo-relative)",
+        initialValue: partial.integrationsDocPath ?? base.integrationsDocPath,
+        validate: (v) => {
+            if (!v.trim())
+                return "path required";
+            if (v.includes(".."))
+                return "path must not contain ..";
+            return undefined;
+        },
+    });
+    if (wizardCancelled(docPath)) {
+        p.cancel("init cancelled");
+        return null;
+    }
+    return { ides: selectedIdes, integrationsDocPath: docPath.trim() };
+}
+async function promptInitArchitecture(partial, base) {
+    const architectureSource = await p.select({
+        message: "Code architecture documentation",
+        options: [
+            {
+                value: "unset",
+                label: "Not defined yet — agents ask before implementing (recommended)",
+            },
+            { value: "file", label: "Single markdown file (docs/ARCHITECTURE.md)" },
+            { value: "directory", label: "Documentation folder" },
+            { value: "external", label: "External wiki / tool (may need auth)" },
+        ],
+        initialValue: (partial.architectureSource ?? base.architectureSource),
+    });
+    if (wizardCancelled(architectureSource)) {
+        p.cancel("init cancelled");
+        return null;
+    }
+    let architectureLocation;
+    if (architectureSource !== "unset") {
+        const locAnswer = await p.text({
+            message: "Architecture location (repo path or URL)",
+            initialValue: partial.architectureLocation ??
+                defaultArchitectureLocation(architectureSource),
+            validate: (v) => {
+                if (!v.trim())
+                    return "location required";
+                if (architectureSource !== "external" && v.includes(".."))
+                    return "path must not contain ..";
+                return undefined;
+            },
+        });
+        if (wizardCancelled(locAnswer)) {
+            p.cancel("init cancelled");
+            return null;
+        }
+        architectureLocation = locAnswer.trim();
+    }
+    let architectureAccessRequired;
+    if (architectureSource === "external") {
+        const authAnswer = await p.confirm({
+            message: "Does this external source require authentication?",
+            initialValue: partial.architectureAccessRequired ?? true,
+        });
+        if (wizardCancelled(authAnswer)) {
+            p.cancel("init cancelled");
+            return null;
+        }
+        architectureAccessRequired = authAnswer;
+    }
+    return {
+        architectureSource: architectureSource,
+        architectureLocation,
+        architectureAccessRequired,
+    };
+}
+async function promptInitInfrastructure(partial, base) {
+    const skills = await p.select({
+        message: "Skills preset",
+        options: [
+            { value: "minimal", label: "minimal (ui + logic)" },
+            { value: "specimen", label: "specimen (ui, logic, gapman, substrate)" },
+        ],
+        initialValue: (partial.skillsPreset ?? base.skillsPreset),
+    });
+    if (wizardCancelled(skills)) {
+        p.cancel("init cancelled");
+        return null;
+    }
+    const gitHooks = await p.confirm({
+        message: "Install .githooks (pre-push verify, post-checkout WORKER_LOG)?",
+        initialValue: partial.gitHooks ?? base.gitHooks,
+    });
+    if (wizardCancelled(gitHooks)) {
+        p.cancel("init cancelled");
+        return null;
+    }
+    const ciWorkflow = await p.confirm({
+        message: "Install GitHub CI workflow (.github/workflows/gxt-validate.yml)?",
+        initialValue: partial.ciWorkflow ?? base.ciWorkflow,
+    });
+    if (wizardCancelled(ciWorkflow)) {
+        p.cancel("init cancelled");
+        return null;
+    }
+    return {
+        skillsPreset: skills,
+        gitHooks,
+        ciWorkflow,
+    };
+}
+export async function runInitInteractiveWizard(repoRoot, templatesRoot, partial) {
+    const compat = loadIntegrationCompat(templatesRoot);
+    p.intro("gapman init — OpenGantry substrate bootstrap");
+    const base = defaultInitProfile();
+    const integrations = await promptInitIntegrations(repoRoot, partial, base, compat);
+    if (!integrations)
+        return null;
+    const architecture = await promptInitArchitecture(partial, base);
+    if (!architecture)
+        return null;
+    const infrastructure = await promptInitInfrastructure(partial, base);
+    if (!infrastructure)
+        return null;
+    const profile = mergeInitProfile(base, {
+        ...partial,
+        ...integrations,
+        ...architecture,
+        ...infrastructure,
+    });
+    p.note([
+        `IDEs: ${profile.ides.join(", ")}`,
+        `Doc: ${profile.integrationsDocPath}`,
+        `Architecture: ${profile.architectureSource}${profile.architectureLocation ? ` → ${profile.architectureLocation}` : ""}`,
+        `Skills: ${profile.skillsPreset}`,
+        `Hooks: ${profile.gitHooks ? "yes" : "no"}`,
+        `CI: ${profile.ciWorkflow ? "yes" : "no"}`,
+    ].join("\n"), "Plan");
+    const go = await p.confirm({ message: "Apply this init plan?", initialValue: true });
+    if (wizardCancelled(go) || !go) {
+        p.cancel("init cancelled");
+        return null;
+    }
+    p.outro("Scaffolding…");
+    return profile;
+}
+export function canPromptInitOverwrite(options) {
+    return (options.dryRun !== true &&
+        options.force !== true &&
+        process.stdout.isTTY === true &&
+        process.stdin.isTTY === true);
+}
+export async function promptOverwriteManagedAssets(conflicts) {
+    p.log.warning("Some managed files already exist and differ from templates:");
+    for (const rel of conflicts) {
+        p.log.message(`  ${rel}`);
+    }
+    const answer = await p.confirm({
+        message: "Overwrite these files?",
+        initialValue: false,
+    });
+    if (p.isCancel(answer)) {
+        p.cancel("init cancelled");
+        return null;
+    }
+    return answer;
+}
+//# sourceMappingURL=init-interactive.js.map

package/dist/cli/lib/init-interactive.js.map

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

package/dist/cli/lib/init-plan.d.ts

@@ -0,0 +1,20 @@
+import type { InitAsset } from "./init-assets.js";
+import { type InitAssetSpec } from "./init-asset-catalog.js";
+import type { InitProfile } from "./init-profile.js";
+export interface PlannedWrite {
+    absoluteTarget: string;
+    body: string;
+    executable: boolean;
+}
+export interface InitPlanResult {
+    ok: boolean;
+    writes: PlannedWrite[];
+    skippedUserMutable: string[];
+    unchanged: string[];
+    conflicts: string[];
+}
+export declare function planInitAssets(assets: (InitAsset | InitAssetSpec)[], templatesRoot: string, repoRoot: string, force: boolean): InitPlanResult;
+export declare function applyInitWrites(writes: PlannedWrite[]): void;
+export declare function logInitSummary(writes: PlannedWrite[], skippedUserMutable: string[], unchanged: string[]): void;
+export declare function logInitNextSteps(profile?: InitProfile): void;
+//# sourceMappingURL=init-plan.d.ts.map

package/dist/cli/lib/init-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-plan.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/init-plan.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,CAAC,SAAS,GAAG,aAAa,CAAC,EAAE,EACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,cAAc,CAwChB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAM5D;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EAAE,EACtB,kBAAkB,EAAE,MAAM,EAAE,EAC5B,SAAS,EAAE,MAAM,EAAE,GAClB,IAAI,CAQN;AAeD,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAgB5D"}

package/dist/cli/lib/init-plan.js

@@ -0,0 +1,92 @@
+import fs from "node:fs";
+import path from "node:path";
+import { CLI_NAME } from "./constants.js";
+import { logError, logInfo } from "./cli-io.js";
+import { audienceSectionTitle, filterNextStepsForAudience, formatAudienceNextStep, } from "./audience-output.js";
+import { getOutputAudience } from "./output-context.js";
+import { templatePathForAsset } from "./init-asset-catalog.js";
+export function planInitAssets(assets, templatesRoot, repoRoot, force) {
+    const writes = [];
+    const conflicts = [];
+    const skippedUserMutable = [];
+    const unchanged = [];
+    for (const asset of assets) {
+        const spec = asset;
+        const templateRel = "templatePath" in spec && spec.templatePath
+            ? spec.templatePath
+            : templatePathForAsset(spec);
+        const templateAbs = path.join(templatesRoot, templateRel.split("/").join(path.sep));
+        const targetAbs = path.join(repoRoot, asset.targetPath.split("/").join(path.sep));
+        if (!fs.existsSync(templateAbs)) {
+            logError(`init: missing template for ${asset.targetPath} at ${templateAbs}`);
+            return { ok: false, writes, skippedUserMutable, unchanged, conflicts };
+        }
+        const body = fs.readFileSync(templateAbs, "utf8");
+        const existing = fs.existsSync(targetAbs) ? fs.readFileSync(targetAbs, "utf8") : null;
+        if (existing === null) {
+            writes.push({ absoluteTarget: targetAbs, body, executable: asset.executable === true });
+            continue;
+        }
+        if (existing === body) {
+            unchanged.push(asset.targetPath);
+            continue;
+        }
+        if (asset.mode === "scaffold_only") {
+            skippedUserMutable.push(asset.targetPath);
+            continue;
+        }
+        if (force) {
+            writes.push({ absoluteTarget: targetAbs, body, executable: asset.executable === true });
+            continue;
+        }
+        conflicts.push(asset.targetPath);
+    }
+    return { ok: true, writes, skippedUserMutable, unchanged, conflicts };
+}
+export function applyInitWrites(writes) {
+    for (const w of writes) {
+        fs.mkdirSync(path.dirname(w.absoluteTarget), { recursive: true });
+        fs.writeFileSync(w.absoluteTarget, w.body, "utf8");
+        if (w.executable)
+            fs.chmodSync(w.absoluteTarget, 0o755);
+    }
+}
+export function logInitSummary(writes, skippedUserMutable, unchanged) {
+    logInfo(`${CLI_NAME} init: wrote ${writes.length} files`);
+    if (skippedUserMutable.length > 0) {
+        logInfo(`${CLI_NAME} init: preserved ${skippedUserMutable.length} existing user-managed files`);
+    }
+    if (unchanged.length > 0) {
+        logInfo(`${CLI_NAME} init: ${unchanged.length} files already up to date`);
+    }
+}
+const INIT_NEXT_STEPS = [
+    "edit .gitagent/foreman/MANIFEST.json (tmvc_roots, forbidden_zones, skills) and run gapman check",
+    "git config core.hooksPath .githooks",
+    'gapman teacher set "$(git config user.email)"',
+    'gapman start "<intent>" --msn MSN-0001 --skill-key <manifest-key>',
+    'Teacher: git commit -m "[MSN-0001] legislate mission" including mission file',
+    "eval \"$(gapman runtime env --mission .gitagent/missions/<file>.yaml)\"",
+    "gapman verify --mission .gitagent/missions/<file>.yaml",
+    "source scripts/gxt-runtime-env.sh .gitagent/missions/<file>.yaml",
+    "scripts/gxt-pin-mission.sh .gitagent/missions/<file>.yaml",
+    "gapman onboarding  # guided walkthrough (strict checks)",
+];
+export function logInitNextSteps(profile) {
+    const steps = [...INIT_NEXT_STEPS];
+    if (profile?.integrationsDocPath) {
+        steps.push(`human IDE setup: ${profile.integrationsDocPath}`);
+    }
+    if (profile?.gitHooks === false) {
+        const hookIdx = steps.indexOf("git config core.hooksPath .githooks");
+        if (hookIdx >= 0)
+            steps.splice(hookIdx, 1);
+    }
+    const audience = getOutputAudience();
+    const filtered = filterNextStepsForAudience(audience, steps).map((step) => formatAudienceNextStep(step, audience));
+    const section = audienceSectionTitle(audience) ?? "next steps";
+    logInfo(`${section}:`);
+    for (const step of filtered)
+        logInfo(`  ${step}`);
+}
+//# sourceMappingURL=init-plan.js.map

package/dist/cli/lib/init-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-plan.js","sourceRoot":"","sources":["../../../src/cli/lib/init-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAsB,MAAM,yBAAyB,CAAC;AAiBnF,MAAM,UAAU,cAAc,CAC5B,MAAqC,EACrC,aAAqB,EACrB,QAAgB,EAChB,KAAc;IAEd,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAsB,CAAC;QACpC,MAAM,WAAW,GAAG,cAAc,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY;YAC7D,CAAC,CAAC,IAAI,CAAC,YAAY;YACnB,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACpF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAClF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,8BAA8B,KAAK,CAAC,UAAU,OAAO,WAAW,EAAE,CAAC,CAAC;YAC7E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QACzE,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEtF,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC,CAAC;YACxF,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACnC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC,CAAC;YACxF,SAAS;QACX,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAsB;IACpD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,UAAU;YAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAsB,EACtB,kBAA4B,EAC5B,SAAmB;IAEnB,OAAO,CAAC,GAAG,QAAQ,gBAAgB,MAAM,CAAC,MAAM,QAAQ,CAAC,CAAC;IAC1D,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,QAAQ,oBAAoB,kBAAkB,CAAC,MAAM,8BAA8B,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,QAAQ,UAAU,SAAS,CAAC,MAAM,2BAA2B,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,MAAM,eAAe,GAAa;IAChC,iGAAiG;IACjG,qCAAqC;IACrC,+CAA+C;IAC/C,mEAAmE;IACnE,8EAA8E;IAC9E,yEAAyE;IACzE,wDAAwD;IACxD,kEAAkE;IAClE,2DAA2D;IAC3D,yDAAyD;CAC1D,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,MAAM,KAAK,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC;IACnC,IAAI,OAAO,EAAE,mBAAmB,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,EAAE,QAAQ,KAAK,KAAK,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;QACrE,IAAI,OAAO,IAAI,CAAC;YAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxE,sBAAsB,CAAC,IAAI,EAAE,QAAQ,CAAC,CACvC,CAAC;IACF,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC;IAC/D,OAAO,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/cli/lib/init-profile.d.ts

@@ -0,0 +1,39 @@
+import type { IntegrationIdeKey } from "./integration-compat.js";
+export type SkillsPreset = "minimal" | "specimen";
+/** Where code architecture docs live — unset means agents must ask before implementing. */
+export type ArchitectureSourceKind = "unset" | "file" | "directory" | "external";
+export interface InitProfile {
+    ides: IntegrationIdeKey[];
+    integrationsDocPath: string;
+    skillsPreset: SkillsPreset;
+    gitHooks: boolean;
+    ciWorkflow: boolean;
+    architectureSource: ArchitectureSourceKind;
+    architectureLocation?: string;
+    architectureAccessRequired?: boolean;
+    architectureCredentialSlot?: string;
+    architectureAuthHint?: string;
+}
+export declare const DEFAULT_INTEGRATIONS_DOC_PATH = "docs/INTEGRATIONS.md";
+export declare function defaultInitProfile(): InitProfile;
+export declare function parseArchitectureSource(raw: string): ArchitectureSourceKind;
+export declare function parseIdesCsv(raw: string): IntegrationIdeKey[];
+export declare function validateIntegrationsDocPath(repoRoot: string, relPath: string): string;
+export declare function profileFromCliFlags(opts: {
+    ides?: string;
+    docsPath?: string;
+    skills?: string;
+    hooks?: boolean;
+    noHooks?: boolean;
+    ci?: boolean;
+    noCi?: boolean;
+    archSource?: string;
+    archLocation?: string;
+}): Partial<InitProfile>;
+export declare function mergeInitProfile(base: InitProfile, partial: Partial<InitProfile>): InitProfile;
+export declare function hasFullCliProfile(partial: Partial<InitProfile>): boolean;
+export declare function shouldRunInteractiveWizard(options: {
+    yes?: boolean;
+    partial: Partial<InitProfile>;
+}): boolean;
+//# sourceMappingURL=init-profile.d.ts.map

package/dist/cli/lib/init-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-profile.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/init-profile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAElD,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,sBAAsB,CAAC;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AAEpE,wBAAgB,kBAAkB,IAAI,WAAW,CAShD;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,CAK3E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAO7D;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUrF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,WAAW,CAAC,CAYvB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAa9F;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAQxE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B,GAAG,OAAO,CAKV"}

package/dist/cli/lib/init-profile.js

@@ -0,0 +1,93 @@
+import path from "node:path";
+export const DEFAULT_INTEGRATIONS_DOC_PATH = "docs/INTEGRATIONS.md";
+export function defaultInitProfile() {
+    return {
+        ides: ["cursor"],
+        integrationsDocPath: DEFAULT_INTEGRATIONS_DOC_PATH,
+        skillsPreset: "specimen",
+        gitHooks: true,
+        ciWorkflow: true,
+        architectureSource: "unset",
+    };
+}
+export function parseArchitectureSource(raw) {
+    if (raw === "unset" || raw === "file" || raw === "directory" || raw === "external") {
+        return raw;
+    }
+    throw new Error("init: --arch-source must be unset, file, directory, or external");
+}
+export function parseIdesCsv(raw) {
+    const parts = raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (parts.length === 0)
+        throw new Error("init: --ides requires at least one IDE key");
+    return parts;
+}
+export function validateIntegrationsDocPath(repoRoot, relPath) {
+    const normalized = relPath.replace(/\\/g, "/").replace(/^\/+/, "");
+    if (normalized.includes(".."))
+        throw new Error("init: integrations doc path must not contain ..");
+    if (path.isAbsolute(normalized))
+        throw new Error("init: integrations doc path must be repo-relative");
+    const abs = path.resolve(repoRoot, normalized);
+    const rootResolved = path.resolve(repoRoot);
+    if (abs !== rootResolved && !abs.startsWith(`${rootResolved}${path.sep}`)) {
+        throw new Error("init: integrations doc path escapes repo root");
+    }
+    return normalized;
+}
+export function profileFromCliFlags(opts) {
+    const partial = {};
+    if (opts.ides)
+        partial.ides = parseIdesCsv(opts.ides);
+    if (opts.docsPath)
+        partial.integrationsDocPath = opts.docsPath.replace(/\\/g, "/");
+    if (opts.skills === "minimal" || opts.skills === "specimen")
+        partial.skillsPreset = opts.skills;
+    if (opts.noHooks)
+        partial.gitHooks = false;
+    else if (opts.hooks)
+        partial.gitHooks = true;
+    if (opts.noCi)
+        partial.ciWorkflow = false;
+    else if (opts.ci)
+        partial.ciWorkflow = true;
+    if (opts.archSource)
+        partial.architectureSource = parseArchitectureSource(opts.archSource);
+    if (opts.archLocation)
+        partial.architectureLocation = opts.archLocation.replace(/\\/g, "/");
+    return partial;
+}
+export function mergeInitProfile(base, partial) {
+    return {
+        ides: partial.ides ?? base.ides,
+        integrationsDocPath: partial.integrationsDocPath ?? base.integrationsDocPath,
+        skillsPreset: partial.skillsPreset ?? base.skillsPreset,
+        gitHooks: partial.gitHooks ?? base.gitHooks,
+        ciWorkflow: partial.ciWorkflow ?? base.ciWorkflow,
+        architectureSource: partial.architectureSource ?? base.architectureSource,
+        architectureLocation: partial.architectureLocation ?? base.architectureLocation,
+        architectureAccessRequired: partial.architectureAccessRequired ?? base.architectureAccessRequired,
+        architectureCredentialSlot: partial.architectureCredentialSlot ?? base.architectureCredentialSlot,
+        architectureAuthHint: partial.architectureAuthHint ?? base.architectureAuthHint,
+    };
+}
+export function hasFullCliProfile(partial) {
+    return (partial.ides !== undefined &&
+        partial.integrationsDocPath !== undefined &&
+        partial.skillsPreset !== undefined &&
+        partial.gitHooks !== undefined &&
+        partial.ciWorkflow !== undefined);
+}
+export function shouldRunInteractiveWizard(options) {
+    if (options.yes)
+        return false;
+    if (!process.stdout.isTTY)
+        return false;
+    if (hasFullCliProfile(options.partial))
+        return false;
+    return true;
+}
+//# sourceMappingURL=init-profile.js.map

package/dist/cli/lib/init-profile.js.map

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

package/dist/cli/lib/init-tutorial.d.ts

@@ -0,0 +1,2 @@
+export declare function runInitTutorial(): Promise<void>;
+//# sourceMappingURL=init-tutorial.d.ts.map

package/dist/cli/lib/init-tutorial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-tutorial.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/init-tutorial.ts"],"names":[],"mappings":"AAgKA,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAkDrD"}