groundplan 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Groundplan contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# groundplan
+
+Prepares a repository: picks an architecture from stated priorities, assembles the repo from
+composable templates, brands it with your solution name, and wires it for every AI coding tool.
+
+```bash
+npm install -g groundplan
+groundplan
+```
+
+`groundplan doctor` validates the catalog it shipped with — run it first if generation ever
+behaves unexpectedly, since it reports which home directory was resolved.
+
+The templates and catalog live in [`@groundplan/core`](https://www.npmjs.com/package/@groundplan/core),
+which this package depends on; installing the CLI brings them with it.
+
+Full documentation, architecture notes, and the contributor guide are in the
+[repository](https://github.com/groundplan/groundplan#readme).
+
+MIT licensed.

package/dist/args.d.ts

@@ -0,0 +1,8 @@
+/** Minimal flag parsing — the CLI's surface is small enough that a dependency is not worth it. */
+export interface Args {
+    positional: string[];
+    flags: Record<string, string | boolean>;
+}
+export declare function parseArgs(argv: string[]): Args;
+export declare function flagString(args: Args, name: string): string | undefined;
+export declare function flagBool(args: Args, name: string): boolean;

package/dist/args.js

@@ -0,0 +1,30 @@
+export function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (!token.startsWith('--')) {
+            positional.push(token);
+            continue;
+        }
+        const [name, inline] = token.slice(2).split('=');
+        if (inline !== undefined) {
+            flags[name] = inline;
+        }
+        else if (argv[i + 1] && !argv[i + 1].startsWith('--')) {
+            flags[name] = argv[++i];
+        }
+        else {
+            flags[name] = true;
+        }
+    }
+    return { positional, flags };
+}
+export function flagString(args, name) {
+    const value = args.flags[name];
+    return typeof value === 'string' ? value : undefined;
+}
+export function flagBool(args, name) {
+    return args.flags[name] === true || args.flags[name] === 'true';
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAqC,EAAE,CAAC;IAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAU,EAAE,IAAY;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAU,EAAE,IAAY;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC;AAClE,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,7 @@
+import { type GroundplanConfig } from '@groundplan/core';
+/**
+ * Validates every YAML against the schema, every cross-reference, and the rules that keep
+ * the multi-tool layer honest. Run this in CI — a dangling id or a duplicated instruction
+ * file is invisible until it reaches a generated repo.
+ */
+export declare function cmdDoctor(_argv: string[], config: GroundplanConfig): Promise<void>;

package/dist/commands/doctor.js

@@ -0,0 +1,123 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import pc from 'picocolors';
+import { checkCapabilityCoverage, checkDelegationCompliance, checkGoverningRule, loadCatalog, } from '@groundplan/core';
+import { templatePaths } from '@groundplan/core';
+/**
+ * A wrong GROUNDPLAN_HOME finds nothing, and "nothing" trivially satisfies every
+ * consistency check. Reporting that as healthy is the one failure mode a validator must
+ * never have, so the paths are proven real before anything is judged.
+ */
+async function assertHomeIsReal(config) {
+    const required = [
+        ['catalog', config.paths.catalog],
+        ['templates', config.paths.templates],
+        ['adapters', config.paths.adapters],
+    ];
+    const missing = [];
+    for (const [label, dir] of required) {
+        const stat = await fs.stat(dir).catch(() => null);
+        if (!stat?.isDirectory())
+            missing.push(`${label}/ (${dir})`);
+    }
+    if (missing.length) {
+        throw new Error(`GROUNDPLAN_HOME does not look like a Groundplan repository.\n` +
+            `  home: ${config.groundplanHome}\n` +
+            `  missing: ${missing.join(', ')}\n` +
+            `Set GROUNDPLAN_HOME to the repository root, or run from inside it.`);
+    }
+}
+/** An empty catalog passes every cross-reference check, which makes a green misleading. */
+function assertNotEmpty(catalog) {
+    const empty = Object.entries({
+        architectures: catalog.architectures.size,
+        blueprints: catalog.blueprints.size,
+        adapters: catalog.adapters.size,
+    })
+        .filter(([, count]) => count === 0)
+        .map(([label]) => label);
+    if (empty.length) {
+        throw new Error(`Catalog is empty: ${empty.join(', ')} loaded nothing.\n` +
+            `Consistency checks pass vacuously on an empty catalog, so this is a failure, not a pass.`);
+    }
+}
+/**
+ * Validates every YAML against the schema, every cross-reference, and the rules that keep
+ * the multi-tool layer honest. Run this in CI — a dangling id or a duplicated instruction
+ * file is invisible until it reaches a generated repo.
+ */
+export async function cmdDoctor(_argv, config) {
+    console.log(pc.dim(`groundplan home: ${config.groundplanHome}\n`));
+    await assertHomeIsReal(config);
+    const catalog = await loadCatalog(config);
+    assertNotEmpty(catalog);
+    const counts = {
+        architectures: catalog.architectures.size,
+        blueprints: catalog.blueprints.size,
+        adapters: catalog.adapters.size,
+        'registry items': catalog.registry.size,
+    };
+    for (const [label, count] of Object.entries(counts)) {
+        console.log(`${count > 0 ? pc.green('✔') : pc.yellow('!')} ${String(count).padStart(4)} ${label}`);
+    }
+    const problems = [
+        ...checkGoverningRule(catalog.adapters.values()),
+        ...checkCapabilityCoverage(catalog.adapters.values(), catalog.registry.values()),
+        ...checkDelegationCompliance(catalog.adapters.values()),
+    ];
+    // An output with no template renders nothing. sync-agents used to skip those in silence,
+    // which is how every adapter came to emit no file while reporting success.
+    for (const adapter of catalog.adapters.values()) {
+        for (const output of adapter.outputs) {
+            const candidates = templatePaths(config, adapter.id, output);
+            const found = await Promise.all(candidates.map((c) => fs.stat(c).then((s) => s.isFile()).catch(() => false)));
+            if (!found.some(Boolean)) {
+                problems.push(`adapter "${adapter.id}" declares output ${output.path} but ships no template — ` +
+                    `tried ${candidates.map((c) => path.relative(config.groundplanHome, c)).join(' or ')}`);
+            }
+        }
+    }
+    // A `verified:` URL says someone looked once. The date says when, so staleness is
+    // measurable instead of assumed — CLI vendors rename flags without announcing it.
+    const now = Date.now();
+    const window = config.adapterVerificationDays * 24 * 60 * 60 * 1000;
+    const stale = [...catalog.adapters.values()]
+        .filter((a) => a.invoke)
+        .map((a) => ({ id: a.id, age: now - Date.parse(a.invoke.verifiedOn) }))
+        .filter((entry) => entry.age > window)
+        .map((entry) => `${entry.id} (${Math.floor(entry.age / 86_400_000)} days)`);
+    if (stale.length) {
+        console.log(pc.yellow(`\n${stale.length} adapter(s) need their flags re-checked against vendor docs: `) +
+            pc.yellow(stale.join(', ')));
+    }
+    // The schema already refuses an architecture with neither overlay nor guidance, so anything
+    // here is a deliberate no-layout entry rather than an unfinished one.
+    const guidance = [...catalog.architectures.values()].filter((a) => a.guidance);
+    if (guidance.length) {
+        console.log(pc.dim(`\n${guidance.length} architecture(s) ship guidance rather than a layout: `) +
+            pc.dim(guidance.map((a) => a.id).join(', ')));
+    }
+    // An architecture no base supports cannot be chosen: `pickBase` filters on
+    // supportsArchitectures and throws when nothing survives. `list` and `recommend` still
+    // offer it, so the failure lands on the user at the last step of the interview.
+    const bases = [...catalog.blueprints.values()].filter((b) => b.kind === 'base');
+    for (const architecture of catalog.architectures.values()) {
+        const supporting = bases.filter((b) => b.supportsArchitectures.length === 0 || b.supportsArchitectures.includes(architecture.id));
+        if (supporting.length === 0) {
+            problems.push(`architecture "${architecture.id}" is offered by list and recommend but no base ` +
+                `declares it in supportsArchitectures, so choosing it aborts \`groundplan new\``);
+        }
+    }
+    if (problems.length) {
+        console.log(pc.red(`\n✖ ${problems.length} problem(s):`));
+        for (const problem of problems)
+            console.log(pc.red(`  - ${problem}`));
+        process.exitCode = 1;
+        return;
+    }
+    console.log(pc.green('\n✔ catalog is internally consistent'));
+    console.log(pc.green('✔ no adapter duplicates AGENTS.md'));
+    console.log(pc.green('✔ every declared capability has a matching output'));
+    console.log(pc.green('✔ every delegation target complies with ADR 0007'));
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,2 @@
+import { type GroundplanConfig } from '@groundplan/core';
+export declare function cmdList(argv: string[], config: GroundplanConfig): Promise<void>;

package/dist/commands/list.js

@@ -0,0 +1,33 @@
+import pc from 'picocolors';
+import { loadCatalog } from '@groundplan/core';
+import { parseArgs } from '../args.js';
+const KINDS = ['architectures', 'blueprints', 'adapters', 'registry'];
+export async function cmdList(argv, config) {
+    const args = parseArgs(argv);
+    const requested = args.positional[0] ?? undefined;
+    if (requested && !KINDS.includes(requested)) {
+        throw new Error(`Unknown kind "${requested}". Expected one of: ${KINDS.join(', ')}`);
+    }
+    const catalog = await loadCatalog(config);
+    for (const kind of requested ? [requested] : KINDS) {
+        const items = [...catalog[kind].values()];
+        console.log(`\n${pc.bold(pc.cyan(kind))} ${pc.dim(`(${items.length})`)}`);
+        if (items.length === 0) {
+            console.log(pc.dim('  none yet'));
+            continue;
+        }
+        for (const item of items) {
+            const meta = 'family' in item ? pc.dim(`[${item.family}/${item.complexity}]`)
+                : 'kind' in item ? pc.dim(`[${item.kind}]`)
+                    : 'readsAgentsMd' in item ? pc.dim(item.readsAgentsMd ? '[native AGENTS.md]' : '[wrapper]')
+                        : '';
+            const summary = 'oneLine' in item ? item.oneLine : 'description' in item ? item.description : '';
+            console.log(`  ${pc.green(item.id.padEnd(24))} ${meta} ${pc.dim(truncate(summary, 70))}`);
+        }
+    }
+    console.log();
+}
+function truncate(text, max) {
+    return text.length <= max ? text : text.slice(0, max - 1) + '…';
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/new.d.ts

@@ -0,0 +1,2 @@
+import { type GroundplanConfig } from '@groundplan/core';
+export declare function cmdNew(argv: string[], config: GroundplanConfig): Promise<void>;

package/dist/commands/new.js

@@ -0,0 +1,266 @@
+import path from 'node:path';
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+import { apply, buildPlan, choiceSets, commandVars, delegationToolsJson, engineGlobals, hasRequiredFailure, loadCatalog, recommend, renderAdapterFiles, writeAdapterFiles, resolve, test as testCondition, } from '@groundplan/core';
+import { flagBool, flagString, parseArgs } from '../args.js';
+import { askAnswers } from './recommend.js';
+export async function cmdNew(argv, config) {
+    const args = parseArgs(argv);
+    const dryRun = flagBool(args, 'dry-run');
+    p.intro(pc.bgCyan(pc.black(' groundplan new ')));
+    const catalog = await loadCatalog(config);
+    if (catalog.blueprints.size === 0) {
+        throw new Error('No blueprints installed. Run `groundplan doctor` and check templates/.');
+    }
+    const solutionName = args.positional[0] ?? (await askSolutionName());
+    const target = path.resolve(flagString(args, 'target') ?? solutionName);
+    const answers = await askAnswers();
+    // Rank first, then let the user override — the recommendation is advice, not a lock.
+    const ranked = recommend(catalog.architectures.values(), {
+        priorities: answers.priorities,
+        teamSize: answers.teamSize,
+        stack: answers.stack,
+        family: answers.family,
+    });
+    const architecture = await pickArchitecture(ranked);
+    const base = await pickBase(catalog, answers.stack, architecture);
+    const layers = await pickLayers(catalog, base);
+    const adapters = await pickAdapters(catalog, config);
+    const selected = resolve({ base, architecture, layers }, catalog.blueprints);
+    for (const warning of selected.warnings)
+        p.log.warn(warning);
+    const vars = {
+        ...engineGlobals({
+            solutionName,
+            base,
+            stack: answers.stack,
+            teamSize: answers.teamSize,
+            architecture,
+            adapters,
+            today: new Date().toISOString().slice(0, 10),
+            delegationTools: delegationToolsJson(adapters.map((id) => catalog.adapters.get(id)).filter((a) => a !== undefined)),
+        }),
+        ...commandVars(selected.order, answers.stack, config),
+        ...(await askBlueprintVariables(selected.order, { base, stack: answers.stack, architecture })),
+    };
+    const plan = await buildPlan({ solution: solutionName, target, blueprints: selected.order, adapters, architecture, vars }, config);
+    printPlan(plan);
+    for (const warning of plan.warnings)
+        p.log.warn(warning);
+    if (dryRun) {
+        p.outro(pc.dim('Dry run — nothing written.'));
+        return;
+    }
+    const approved = await p.confirm({ message: `Write ${plan.files.length} files to ${target}?` });
+    if (p.isCancel(approved) || !approved) {
+        p.cancel('Nothing written.');
+        return;
+    }
+    const spinner = p.spinner();
+    spinner.start('Generating');
+    const result = await apply(plan, config, { onProgress: (m) => spinner.message(m) });
+    spinner.stop(`Wrote ${result.written.length} files`);
+    // Compile AGENTS.md outward, one file per selected tool. Without this the repo has the
+    // source of truth and nothing pointing at it, which is the whole point of the adapters.
+    const emitted = await renderAdapterFiles({
+        adapters: adapters.map((id) => catalog.adapters.get(id)).filter((a) => a !== undefined),
+        registry: [...catalog.registry.values()],
+        vars,
+        config,
+    });
+    await writeAdapterFiles(target, emitted.files);
+    const perTool = new Map();
+    for (const file of emitted.files)
+        perTool.set(file.adapter, (perTool.get(file.adapter) ?? 0) + 1);
+    for (const [id, count] of perTool)
+        p.log.success(`${id}: ${count} file(s)`);
+    for (const reason of emitted.skipped)
+        p.log.warn(reason);
+    for (const step of result.postApply) {
+        if (step.ok)
+            p.log.success(step.command);
+        else if (step.optional)
+            p.log.warn(`${step.command} — failed, run it manually`);
+        else
+            p.log.error(`${step.command} — REQUIRED and failed; the repo is incomplete`);
+    }
+    if (hasRequiredFailure(result)) {
+        p.outro(pc.red('Generated, but a required step failed. Fix it before using this repo.'));
+        process.exitCode = 1;
+        return;
+    }
+    p.outro(`${pc.green('✔')} ${solutionName} ready at ${pc.cyan(target)}`);
+}
+async function askSolutionName() {
+    const value = await p.text({
+        message: 'Solution name',
+        placeholder: 'acme-billing',
+        validate: (v) => (v.trim().length > 0 ? undefined : 'Required'),
+    });
+    assertNotCancelled(value);
+    return value.trim();
+}
+async function pickArchitecture(ranked) {
+    if (ranked.length === 0)
+        return undefined;
+    const value = await p.select({
+        message: 'Architecture',
+        options: ranked.slice(0, 6).map((r, i) => ({
+            value: r.architecture.id,
+            label: `${r.architecture.name}${i === 0 ? pc.green('  ← recommended') : ''}`,
+            hint: `${Math.round(r.fit * 100)}% fit — ${r.architecture.keyTradeoff}`,
+        })),
+    });
+    assertNotCancelled(value);
+    return value;
+}
+async function pickBase(catalog, stack, architecture) {
+    const bases = [...catalog.blueprints.values()].filter((b) => b.kind === 'base' &&
+        b.stack === stack &&
+        (!architecture || b.supportsArchitectures.length === 0 || b.supportsArchitectures.includes(architecture)));
+    if (bases.length === 0) {
+        // Two very different causes; saying "no base for this stack" when eight exist sends the
+        // reader looking in the wrong place.
+        const forStack = [...catalog.blueprints.values()].filter((b) => b.kind === 'base' && b.stack === stack);
+        throw new Error(forStack.length === 0
+            ? `No base template for stack "${stack}" yet.`
+            : `No ${stack} base supports the "${architecture}" architecture. ` +
+                `Bases for this stack: ${forStack.map((b) => b.id).join(', ')}. ` +
+                `A base opts in through supportsArchitectures in its blueprint.yaml.`);
+    }
+    if (bases.length === 1)
+        return bases[0].id;
+    const value = await p.select({
+        message: 'Base template',
+        options: bases.map((b) => ({ value: b.id, label: b.name, hint: b.description })),
+    });
+    assertNotCancelled(value);
+    return value;
+}
+/**
+ * Choice sets are asked first as pick-one (database, ORM, auth provider…), then everything
+ * else as checkboxes. Presenting exclusive alternatives as checkboxes invites a selection
+ * the resolver will only reject afterwards.
+ */
+async function pickLayers(catalog, base) {
+    const baseStack = catalog.blueprints.get(base)?.stack;
+    const layers = [...catalog.blueprints.values()].filter((b) => b.kind === 'layer' && (!b.stack || b.stack === baseStack));
+    if (layers.length === 0)
+        return [];
+    const selected = [];
+    const sets = choiceSets(layers);
+    for (const [setName, options] of [...sets.entries()].sort()) {
+        const preselected = options.find((o) => o.choiceDefault);
+        const value = await p.select({
+            message: `${setName.replace(/-/g, ' ')}`,
+            initialValue: preselected?.id,
+            options: [
+                ...options.map((o) => ({ value: o.id, label: o.name, hint: o.description })),
+                { value: '', label: 'None', hint: 'skip this' },
+            ],
+        });
+        assertNotCancelled(value);
+        if (value)
+            selected.push(value);
+    }
+    const rest = layers.filter((l) => !l.choiceSet);
+    if (rest.length === 0)
+        return selected;
+    const extras = await p.multiselect({
+        message: 'Capabilities',
+        options: rest.map((l) => ({ value: l.id, label: l.name, hint: l.description })),
+        required: false,
+    });
+    assertNotCancelled(extras);
+    return [...selected, ...extras];
+}
+async function pickAdapters(catalog, config) {
+    const available = [...catalog.adapters.values()];
+    if (available.length === 0)
+        return [];
+    const value = await p.multiselect({
+        message: 'Which AI coding tools will touch this repo?',
+        options: available.map((a) => ({
+            value: a.id,
+            label: a.name,
+            hint: a.readsAgentsMd ? 'reads AGENTS.md natively' : 'needs a wrapper file',
+        })),
+        initialValues: config.defaultAdapters.filter((id) => catalog.adapters.has(id)),
+        required: false,
+    });
+    assertNotCancelled(value);
+    return value;
+}
+/**
+ * Only asks questions the selected blueprints actually declared, and only those whose `when`
+ * holds. Skipping the condition asked a .NET user which Python package manager to use, and —
+ * worse — recorded an answer the templates then rendered as fact.
+ *
+ * A skipped variable still takes its declared default, because a template may reference it
+ * even on a stack that was never asked: the docker layer's compose file names a Dockerfile
+ * whose suffix only one stack chooses.
+ */
+async function askBlueprintVariables(blueprints, context) {
+    const answers = {};
+    const asked = new Set();
+    const skipped = [];
+    for (const blueprint of blueprints) {
+        for (const variable of blueprint.variables) {
+            if (asked.has(variable.name))
+                continue;
+            asked.add(variable.name);
+            if (!testCondition(variable.when, { ...context, ...answers })) {
+                skipped.push(variable);
+                asked.delete(variable.name);
+                continue;
+            }
+            const value = variable.type === 'boolean'
+                ? await p.confirm({ message: variable.prompt, initialValue: Boolean(variable.default) })
+                : variable.type === 'select'
+                    ? await p.select({
+                        message: variable.prompt,
+                        options: (variable.choices ?? []).map((c) => ({ value: c.value, label: c.label })),
+                    })
+                    : await p.text({
+                        message: variable.prompt,
+                        defaultValue: variable.default === undefined ? '' : String(variable.default),
+                    });
+            assertNotCancelled(value);
+            answers[variable.name] = value;
+        }
+    }
+    // A template may reference a variable this stack was never asked for. Its declared default
+    // is the right value; leaving it unset would fail generation on an unresolved token.
+    for (const variable of skipped) {
+        if (!(variable.name in answers) && variable.default !== undefined) {
+            answers[variable.name] = variable.default;
+        }
+    }
+    return answers;
+}
+function printPlan(plan) {
+    const byBlueprint = new Map();
+    for (const file of plan.files) {
+        byBlueprint.set(file.fromBlueprint, (byBlueprint.get(file.fromBlueprint) ?? 0) + 1);
+    }
+    console.log(`\n${pc.bold('Plan')} ${pc.dim(`— ${plan.files.length} files`)}`);
+    for (const [blueprint, count] of byBlueprint) {
+        console.log(`  ${pc.cyan(blueprint.padEnd(24))} ${pc.dim(`${count} files`)}`);
+    }
+    if (plan.adapters.length)
+        console.log(`  ${pc.cyan('ai-tools'.padEnd(24))} ${pc.dim(plan.adapters.join(', '))}`);
+    if (plan.postApply.length) {
+        console.log(`\n${pc.dim('After writing:')}`);
+        for (const step of plan.postApply) {
+            console.log(pc.dim(`  $ ${step.run}${step.optional ? '' : '   (required)'}`));
+        }
+    }
+    console.log();
+}
+function assertNotCancelled(value) {
+    if (p.isCancel(value)) {
+        p.cancel('Cancelled.');
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=new.js.map

package/dist/commands/new.js.map

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

package/dist/commands/recommend.d.ts

@@ -0,0 +1,9 @@
+import { type Characteristic, type GroundplanConfig, type Stack } from '@groundplan/core';
+export interface Answers {
+    stack: Stack;
+    teamSize: number;
+    priorities: Partial<Record<Characteristic, number>>;
+    family?: 'application' | 'system' | 'frontend' | 'data' | 'ai';
+}
+export declare function askAnswers(): Promise<Answers>;
+export declare function cmdRecommend(argv: string[], config: GroundplanConfig): Promise<void>;

package/dist/commands/recommend.js

@@ -0,0 +1,101 @@
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+import { loadCatalog, recommend, } from '@groundplan/core';
+import { parseArgs } from '../args.js';
+/** The interview. Kept short — every question must change the ranking or it is cut. */
+const PRIORITY_CHOICES = [
+    { value: 'simplicity', label: 'Simplicity', hint: 'ship fast, few moving parts' },
+    { value: 'scalability', label: 'Scalability', hint: 'grow with load' },
+    { value: 'deployability', label: 'Deployability', hint: 'deploy often, independently' },
+    { value: 'testability', label: 'Testability', hint: 'fast, isolated tests' },
+    { value: 'evolvability', label: 'Evolvability', hint: 'change direction cheaply' },
+    { value: 'fault-tolerance', label: 'Fault tolerance', hint: 'survive partial failure' },
+    { value: 'maintainability', label: 'Maintainability', hint: 'easy to change safely' },
+    { value: 'elasticity', label: 'Elasticity', hint: 'absorb sudden spikes' },
+    { value: 'responsiveness', label: 'Responsiveness', hint: 'low latency to the user' },
+    { value: 'cost', label: 'Low cost', hint: 'minimize infrastructure spend' },
+];
+export async function askAnswers() {
+    const stack = (await p.select({
+        message: 'Primary stack',
+        options: [
+            { value: 'typescript', label: 'TypeScript / Next.js / React' },
+            { value: 'python', label: 'Python / FastAPI / AI-ML' },
+            { value: 'dotnet', label: '.NET / C#' },
+            { value: 'node', label: 'Node backend / NestJS / Express' },
+            { value: 'go', label: 'Go' },
+            { value: 'polyglot', label: 'Polyglot / monorepo' },
+        ],
+    }));
+    assertNotCancelled(stack);
+    const teamSizeRaw = await p.text({
+        message: 'How many engineers will work on this?',
+        placeholder: '4',
+        defaultValue: '4',
+        validate: (v) => (Number.isFinite(Number(v)) && Number(v) > 0 ? undefined : 'Enter a positive number'),
+    });
+    assertNotCancelled(teamSizeRaw);
+    const family = (await p.select({
+        message: 'What are you deciding?',
+        options: [
+            { value: 'application', label: 'Application/code structure', hint: 'layered, clean, vertical-slice…' },
+            { value: 'system', label: 'System topology', hint: 'monolith, microservices, event-driven…' },
+            { value: 'frontend', label: 'Frontend structure' },
+            { value: 'ai', label: 'AI/agent architecture' },
+            { value: 'data', label: 'Data architecture' },
+        ],
+    }));
+    assertNotCancelled(family);
+    const chosen = (await p.multiselect({
+        message: 'What matters most? (pick 2-4)',
+        options: PRIORITY_CHOICES,
+        required: true,
+    }));
+    assertNotCancelled(chosen);
+    // Weight by selection order: the first pick counts most, so ties break meaningfully.
+    const priorities = {};
+    chosen.forEach((c, i) => {
+        priorities[c] = Math.max(5 - i, 2);
+    });
+    return { stack, teamSize: Number(teamSizeRaw), priorities, family };
+}
+export async function cmdRecommend(argv, config) {
+    parseArgs(argv);
+    p.intro(pc.bgCyan(pc.black(' groundplan recommend ')));
+    const catalog = await loadCatalog(config);
+    if (catalog.architectures.size === 0) {
+        throw new Error('Catalog is empty. Run `groundplan doctor` and check catalog/architectures/.');
+    }
+    const answers = await askAnswers();
+    const ranked = recommend(catalog.architectures.values(), {
+        priorities: answers.priorities,
+        teamSize: answers.teamSize,
+        stack: answers.stack,
+        family: answers.family,
+    });
+    if (ranked.length === 0) {
+        p.outro(pc.yellow('No architecture in the catalog fits those constraints.'));
+        return;
+    }
+    console.log();
+    for (const [rank, result] of ranked.slice(0, 5).entries()) {
+        const badge = rank === 0 ? pc.green('▸ RECOMMENDED') : pc.dim(`  #${rank + 1}`);
+        console.log(`${badge} ${pc.bold(result.architecture.name)} ${pc.dim(`(${Math.round(result.fit * 100)}% fit)`)}`);
+        console.log(`    ${pc.dim(result.architecture.oneLine)}`);
+        for (const reason of result.reasons.slice(0, 3))
+            console.log(`    ${pc.green('+')} ${reason}`);
+        for (const concern of result.concerns.slice(0, 3))
+            console.log(`    ${pc.yellow('!')} ${concern}`);
+        if (rank === 0)
+            console.log(`    ${pc.dim('trade-off: ' + result.architecture.keyTradeoff)}`);
+        console.log();
+    }
+    p.outro(pc.dim('Run `groundplan new <name>` to scaffold with the recommended architecture.'));
+}
+function assertNotCancelled(value) {
+    if (p.isCancel(value)) {
+        p.cancel('Cancelled.');
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=recommend.js.map

package/dist/commands/recommend.js.map

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

package/dist/commands/sync-agents.d.ts

@@ -0,0 +1,12 @@
+import { type GroundplanConfig } from '@groundplan/core';
+/**
+ * Regenerates every AI tool's wrapper file from AGENTS.md in an existing repo.
+ * Run it after editing AGENTS.md so no tool's view can drift from the source of truth.
+ *
+ * Only wrappers. A rule, command, agent or skill file is rendered once per registry item and
+ * a settings file needs the project's build commands — neither is knowable from a repo that
+ * already exists, so this command reports them rather than inventing values.
+ */
+export declare function cmdSyncAgents(argv: string[], config: GroundplanConfig): Promise<void>;
+/** Templates are named after the file they produce, plus `.tmpl`. */
+export declare function templateFor(config: GroundplanConfig, adapterId: string, outputPath: string): string;

package/dist/commands/sync-agents.js

@@ -0,0 +1,99 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import pc from 'picocolors';
+import { AGENTS_FILE, collectTokens, loadCatalog, renderContent, } from '@groundplan/core';
+import { flagBool, flagString, parseArgs } from '../args.js';
+/**
+ * Regenerates every AI tool's wrapper file from AGENTS.md in an existing repo.
+ * Run it after editing AGENTS.md so no tool's view can drift from the source of truth.
+ *
+ * Only wrappers. A rule, command, agent or skill file is rendered once per registry item and
+ * a settings file needs the project's build commands — neither is knowable from a repo that
+ * already exists, so this command reports them rather than inventing values.
+ */
+export async function cmdSyncAgents(argv, config) {
+    const args = parseArgs(argv);
+    const target = path.resolve(flagString(args, 'target') ?? process.cwd());
+    const dryRun = flagBool(args, 'dry-run');
+    const agentsFile = path.join(target, AGENTS_FILE);
+    if (!(await exists(agentsFile))) {
+        throw new Error(`No ${AGENTS_FILE} in ${target}. It is the source of truth; create it first.`);
+    }
+    const catalog = await loadCatalog(config);
+    const requested = flagString(args, 'tools')?.split(',').map((s) => s.trim());
+    const adapters = [...catalog.adapters.values()].filter((a) => !requested || requested.includes(a.id));
+    if (adapters.length === 0)
+        throw new Error('No matching adapters. Run `groundplan list adapters`.');
+    /** Everything a sync of an existing repo can honestly supply. */
+    const vars = { agentsMdPath: AGENTS_FILE, solutionName: path.basename(target) };
+    const available = new Set(Object.keys(vars));
+    const written = [];
+    const deferred = [];
+    const missing = [];
+    for (const adapter of adapters) {
+        if (adapter.readsAgentsMd) {
+            console.log(`${pc.dim('skip')}      ${adapter.id} ${pc.dim(`— reads ${AGENTS_FILE} natively`)}`);
+        }
+        for (const output of adapter.outputs) {
+            // Native readers get no wrapper — a duplicate file is exactly what causes drift.
+            if (adapter.readsAgentsMd && output.mode === 'wrapper')
+                continue;
+            // A `__token__` in the path means one file per registry item, which generation expands.
+            if (/__[A-Za-z]/.test(output.path)) {
+                deferred.push(`${adapter.id}: ${output.path} — one per registry item, written by \`groundplan new\``);
+                continue;
+            }
+            const templateFile = templateFor(config, adapter.id, output.path);
+            if (!(await exists(templateFile))) {
+                missing.push(`${adapter.id}: ${output.path} — no ${path.relative(config.groundplanHome, templateFile)}`);
+                continue;
+            }
+            const source = await fs.readFile(templateFile, 'utf8');
+            const needs = collectTokens(source).filter((token) => !available.has(token));
+            if (needs.length > 0) {
+                // Build commands and MCP config come from the blueprint that generated the repo, not
+                // from the repo itself. Rendering a guess would write a wrong file confidently.
+                deferred.push(`${adapter.id}: ${output.path} — needs ${needs.join(', ')}, known only at generation`);
+                continue;
+            }
+            const destination = path.join(target, output.path);
+            console.log(`${dryRun ? pc.dim('would write') : pc.green('write')} ${output.path} ${pc.dim(`(${adapter.id})`)}`);
+            if (!dryRun) {
+                await fs.mkdir(path.dirname(destination), { recursive: true });
+                await fs.writeFile(destination, renderContent(source, vars, templateFile), 'utf8');
+            }
+            written.push(output.path);
+        }
+    }
+    for (const entry of deferred)
+        console.log(`${pc.dim('defer')}     ${pc.dim(entry)}`);
+    // A declared output with no template on disk is a catalog defect. It used to be skipped in
+    // silence, which is how every adapter came to emit nothing while the command reported success.
+    if (missing.length) {
+        console.log(pc.red(`\n✖ ${missing.length} declared output(s) have no template:`));
+        for (const entry of missing)
+            console.log(pc.red(`  - ${entry}`));
+        console.log(pc.dim('  Add the template, or remove the output from the adapter. `groundplan check:catalog` also reports these.'));
+        process.exitCode = 1;
+        return;
+    }
+    if (written.length === 0) {
+        console.log(pc.yellow(`\n! nothing to sync — every selected adapter reads ${AGENTS_FILE} natively.`));
+        return;
+    }
+    console.log(`\n${pc.green('✔')} ${written.length} file(s) ${dryRun ? 'planned' : 'synced'} from ${AGENTS_FILE}`);
+}
+/** Templates are named after the file they produce, plus `.tmpl`. */
+export function templateFor(config, adapterId, outputPath) {
+    return path.join(config.paths.adapters, adapterId, 'templates', `${path.basename(outputPath)}.tmpl`);
+}
+async function exists(target) {
+    try {
+        await fs.access(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=sync-agents.js.map

package/dist/commands/sync-agents.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+/**
+ * groundplan — prepare a repository so a project starts at "write the feature"
+ * instead of "decide everything again".
+ */
+import pc from 'picocolors';
+import { loadConfig } from '@groundplan/core';
+import { cmdNew } from './commands/new.js';
+import { cmdList } from './commands/list.js';
+import { cmdRecommend } from './commands/recommend.js';
+import { cmdSyncAgents } from './commands/sync-agents.js';
+import { cmdDoctor } from './commands/doctor.js';
+const COMMANDS = {
+    new: { run: cmdNew, help: 'Create a new repository (interactive)' },
+    list: { run: cmdList, help: 'List architectures, blueprints, adapters, registry items' },
+    recommend: { run: cmdRecommend, help: 'Rank architectures against your project priorities' },
+    'sync-agents': { run: cmdSyncAgents, help: 'Regenerate AI-tool files from agent-kit in an existing repo' },
+    doctor: { run: cmdDoctor, help: 'Validate the catalog and report dangling references' },
+};
+function usage() {
+    console.log(`
+${pc.bold('groundplan')} — scalable repository scaffolding
+
+${pc.dim('Usage:')} groundplan <command> [options]
+
+${Object.entries(COMMANDS)
+        .map(([name, { help }]) => `  ${pc.cyan(name.padEnd(13))} ${help}`)
+        .join('\n')}
+
+${pc.dim('Common flags:')}
+  --dry-run        Plan only; write nothing
+  --yes            Accept defaults, skip the interview
+  --target <dir>   Output directory (default: ./<name>)
+
+${pc.dim('Configuration is environment-driven; see docs/ARCHITECTURE.md section 8.')}
+`);
+}
+async function main() {
+    const [command, ...argv] = process.argv.slice(2);
+    if (!command || command === '--help' || command === '-h') {
+        usage();
+        return;
+    }
+    const entry = COMMANDS[command];
+    if (!entry) {
+        console.error(pc.red(`Unknown command "${command}"`));
+        usage();
+        process.exitCode = 1;
+        return;
+    }
+    await entry.run(argv, loadConfig());
+}
+main().catch((error) => {
+    console.error(pc.red('\n✖ ' + (error instanceof Error ? error.message : String(error))));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,QAAQ,GAAG;IACf,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,uCAAuC,EAAE;IACnE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,0DAA0D,EAAE;IACxF,SAAS,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,oDAAoD,EAAE;IAC5F,aAAa,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,6DAA6D,EAAE;IAC1G,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,qDAAqD,EAAE;CAC/E,CAAC;AAEX,SAAS,KAAK;IACZ,OAAO,CAAC,GAAG,CAAC;EACZ,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;;EAErB,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC;;EAEhB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;SACvB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;SAClE,IAAI,CAAC,IAAI,CAAC;;EAEX,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC;;;;;EAKvB,EAAE,CAAC,GAAG,CAAC,0EAA0E,CAAC;CACnF,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEjD,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACzD,KAAK,EAAE,CAAC;QACR,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAgC,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,oBAAoB,OAAO,GAAG,CAAC,CAAC,CAAC;QACtD,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "groundplan",
+  "version": "0.1.0",
+  "description": "Groundplan CLI: prepare a repository — pick an architecture, assemble it from templates, and wire it for every AI coding tool.",
+  "license": "MIT",
+  "author": "Groundplan contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/groundplan/groundplan.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/groundplan/groundplan#readme",
+  "bugs": "https://github.com/groundplan/groundplan/issues",
+  "keywords": [
+    "cli",
+    "scaffolding",
+    "templates",
+    "architecture",
+    "agents",
+    "agents-md"
+  ],
+  "type": "module",
+  "bin": {
+    "groundplan": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.0",
+    "picocolors": "^1.1.1",
+    "@groundplan/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}