@opengroundplan/core 0.1.1

package/dist/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AASjC,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrE,CAAC;AAQD,qFAAqF;AACrF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;IACjC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAU,EAAE,MAAwB,EAAE,UAAwB,EAAE;IAC1F,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/D,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBAChE,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBACpG,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,KAAK,OAAO;oBACrB,CAAC,CAAC,MAAM,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CACxD,OAAO,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,aAAa,GAAG,CAAC,CAC7D;oBACH,CAAC,CAAC,QAAQ,CAAC;gBACf,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,uFAAuF;QACvF,oCAAoC;QACpC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAE/D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAElC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACzF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACzC,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,SAAS,CACtB,WAAmB,EACnB,QAAgB,EAChB,MAAc,EACd,UAAsC;IAEtC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IACvC,OAAO,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,EAAU;IAC3C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAA4B,EAAE,EAAE;gBAChF,kDAAkD;gBAClD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;oBAAE,MAAM,KAAK,CAAC;gBACxC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,IAAU,EACV,MAAwB,EACxB,OAAqB;IAErB,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,uFAAuF;YACvF,wEAAwE;YACxE,EAAE;YACF,qFAAqF;YACrF,uFAAuF;YACvF,oFAAoF;YACpF,iDAAiD;YACjD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;gBAClD,GAAG,EAAE,IAAI,CAAC,MAAM;gBAChB,OAAO,EAAE,MAAM,CAAC,kBAAkB;aACnC,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;QACnG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uFAAuF;YACvF,qFAAqF;YACrF,6DAA6D;YAC7D,OAAO,CAAC,IAAI,CAAC;gBACX,OAAO,EAAE,IAAI,CAAC,GAAG;gBACjB,EAAE,EAAE,KAAK;gBACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC/D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,MAAc;IAClC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/condition.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Blueprint `when:` conditions. Deliberately a tiny evaluator rather than `eval` or a
+ * JS sandbox — templates are data, and data must never be able to execute.
+ *
+ * Grammar:  expr := term (('&&' | '||') term)*
+ *           term := '!'? (ident | ident op literal | '(' expr ')')
+ *           op   := == | != | > | >= | < | <= | in
+ */
+import type { Vars } from './tokens.js';
+export declare class ConditionError extends Error {
+}
+export declare function evaluate(expression: string, vars: Vars): boolean;
+/** Conditions default to true when absent, so `when:` is always optional in blueprints. */
+export declare function test(expression: string | undefined, vars: Vars): boolean;

package/dist/condition.js

@@ -0,0 +1,121 @@
+const TOKENIZER = /\s*(\(|\)|&&|\|\||!=|==|>=|<=|>|<|!|\bin\b|'[^']*'|"[^"]*"|[A-Za-z_][\w.]*|-?\d+(?:\.\d+)?)/y;
+export class ConditionError extends Error {
+}
+function tokenize(src) {
+    const out = [];
+    TOKENIZER.lastIndex = 0;
+    while (TOKENIZER.lastIndex < src.length) {
+        const start = TOKENIZER.lastIndex;
+        const m = TOKENIZER.exec(src);
+        if (!m)
+            throw new ConditionError(`Cannot parse condition at offset ${start}: ${src}`);
+        out.push({ kind: classify(m[1]), value: m[1] });
+    }
+    return out;
+}
+function classify(raw) {
+    if (/^['"]/.test(raw))
+        return 'string';
+    if (/^-?\d/.test(raw))
+        return 'number';
+    if (['(', ')', '&&', '||', '!', '==', '!=', '>=', '<=', '>', '<', 'in'].includes(raw))
+        return raw;
+    return 'ident';
+}
+/**
+ * Own properties only. Inherited lookup would let a condition read `constructor` off
+ * Object.prototype and reach the function constructor from template data.
+ */
+function lookup(path, vars) {
+    return path.split('.').reduce((acc, key) => {
+        if (acc === null || typeof acc !== 'object')
+            return undefined;
+        return Object.hasOwn(acc, key) ? acc[key] : undefined;
+    }, vars);
+}
+function truthy(v) {
+    if (Array.isArray(v))
+        return v.length > 0;
+    return Boolean(v);
+}
+export function evaluate(expression, vars) {
+    const tokens = tokenize(expression);
+    let pos = 0;
+    const peek = () => tokens[pos];
+    const eat = (kind) => {
+        const t = tokens[pos++];
+        if (!t || (kind && t.kind !== kind)) {
+            throw new ConditionError(`Expected ${kind ?? 'token'} in: ${expression}`);
+        }
+        return t;
+    };
+    function parseValue() {
+        const t = eat();
+        if (t.kind === 'string')
+            return t.value.slice(1, -1);
+        if (t.kind === 'number')
+            return Number(t.value);
+        if (t.kind === 'ident') {
+            if (t.value === 'true')
+                return true;
+            if (t.value === 'false')
+                return false;
+            return lookup(t.value, vars);
+        }
+        throw new ConditionError(`Unexpected "${t.value}" in: ${expression}`);
+    }
+    function parseTerm() {
+        if (peek()?.kind === '!') {
+            eat('!');
+            return !parseTerm();
+        }
+        if (peek()?.kind === '(') {
+            eat('(');
+            const inner = parseExpr();
+            eat(')');
+            return inner;
+        }
+        const left = parseValue();
+        const op = peek()?.kind;
+        if (!op || !['==', '!=', '>', '>=', '<', '<=', 'in'].includes(op))
+            return truthy(left);
+        eat(op);
+        const right = parseValue();
+        switch (op) {
+            case '==':
+                return left === right;
+            case '!=':
+                return left !== right;
+            case '>':
+                return Number(left) > Number(right);
+            case '>=':
+                return Number(left) >= Number(right);
+            case '<':
+                return Number(left) < Number(right);
+            case '<=':
+                return Number(left) <= Number(right);
+            case 'in':
+                return Array.isArray(right) ? right.includes(left) : String(right).includes(String(left));
+            default:
+                throw new ConditionError(`Unsupported operator ${op}`);
+        }
+    }
+    function parseExpr() {
+        let result = parseTerm();
+        while (peek()?.kind === '&&' || peek()?.kind === '||') {
+            const op = eat().kind;
+            const right = parseTerm();
+            result = op === '&&' ? result && right : result || right;
+        }
+        return result;
+    }
+    const value = parseExpr();
+    if (pos !== tokens.length)
+        throw new ConditionError(`Trailing input in: ${expression}`);
+    return value;
+}
+/** Conditions default to true when absent, so `when:` is always optional in blueprints. */
+export function test(expression, vars) {
+    return expression === undefined ? true : evaluate(expression, vars);
+}
+//# sourceMappingURL=condition.js.map

package/dist/condition.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The directories that make a directory the Groundplan home. All four, or it is not it.
+ *
+ * Exported because `scripts/stage-data.mjs` copies exactly these into the package before it is
+ * packed — two lists would drift, and the one that drifts silently is the published one.
+ */
+export declare const DATA_DIRS: readonly ["catalog", "templates", "adapters", "registry"];
+export interface StackCommands {
+    build: string;
+    test: string;
+    lint: string;
+    typecheck?: string;
+    dev?: string;
+}
+export interface GroundplanConfig {
+    groundplanHome: string;
+    catalogDir: string;
+    templatesDir: string;
+    adaptersDir: string;
+    registryDir: string;
+    blueprintFilesDir: string;
+    defaultAdapters: string[];
+    protectedPaths: string[];
+    adapterVerificationDays: number;
+    maxFilesPerPlan: number;
+    maxFileBytes: number;
+    postApplyTimeoutMs: number;
+    stackCommands: Record<string, StackCommands>;
+    paths: {
+        catalog: string;
+        templates: string;
+        adapters: string;
+        registry: string;
+    };
+}
+export declare function loadConfig(): GroundplanConfig;

package/dist/config.js

@@ -0,0 +1,131 @@
+/**
+ * Single source of configuration. Engine code reads settings from here and never
+ * inlines a path, limit, or model id at a call site.
+ *
+ * Precedence: environment > defaults.
+ */
+import { fileURLToPath } from 'node:url';
+import fs from 'node:fs';
+import path from 'node:path';
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * The directories that make a directory the Groundplan home. All four, or it is not it.
+ *
+ * Exported because `scripts/stage-data.mjs` copies exactly these into the package before it is
+ * packed — two lists would drift, and the one that drifts silently is the published one.
+ */
+export const DATA_DIRS = ['catalog', 'templates', 'adapters', 'registry'];
+/**
+ * Finds the directory holding catalog/, templates/, adapters/, and registry/ by walking up
+ * from this module.
+ *
+ * Walked rather than counted. In the workspace the data sits three levels above
+ * `packages/core/dist`; in a published package it sits beside `dist/` inside the package
+ * itself. The fixed `../../..` this replaces resolved to `node_modules/` once installed, so
+ * every published CLI would have found no catalog at all.
+ *
+ * Requiring all four dirs is what keeps the walk from stopping somewhere accidental — a user's
+ * project that happens to have a `templates/` is not a Groundplan home.
+ */
+function discoverHome(from) {
+    let dir = from;
+    for (;;) {
+        if (DATA_DIRS.every((name) => fs.existsSync(path.join(dir, name))))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Nothing found. Return the workspace-shaped guess so the failure surfaces as `doctor`
+    // reporting a missing catalog against a real path, rather than as a throw at import time.
+    return path.resolve(from, '../../..');
+}
+/** Resolved once — the answer cannot change while the process runs, and every command asks. */
+let discovered;
+/** Typed defaults — the only place a literal value is allowed to appear. */
+const defaults = {
+    catalogDir: 'catalog',
+    templatesDir: 'templates',
+    adaptersDir: 'adapters',
+    registryDir: 'registry',
+    /** Template root inside a blueprint. Stripped from destinations so `files/x` lands at `x`. */
+    blueprintFilesDir: 'files',
+    /** Adapters emitted when the user does not choose explicitly. */
+    defaultAdapters: ['claude-code', 'codex', 'cursor', 'github-copilot'],
+    /**
+     * How long a delegation adapter's flag verification is trusted before `doctor` asks for a
+     * recheck. CLI vendors rename flags without notice; a year is long enough not to nag and
+     * short enough that a rename is caught before a user hits it.
+     */
+    adapterVerificationDays: 365,
+    /**
+     * Paths a generated repo asks an agent not to edit unattended. Adapters that can express a
+     * deny rule render this; the rest state it in prose. A generated repo overrides it in its
+     * own hook config — this is the starting set, not a ceiling.
+     */
+    protectedPaths: ['.env', '.env.*', '**/*.pem', '**/*.key', '.github/workflows/**', 'LICENSE'],
+    /** Guardrails so a malformed blueprint cannot exhaust the machine. */
+    maxFilesPerPlan: 5000,
+    maxFileBytes: 5 * 1024 * 1024,
+    postApplyTimeoutMs: 300_000,
+    /**
+     * Fallback toolchain commands per stack, used when a base does not declare its own.
+     * Literals live here because this is the config layer — engine code reads, never inlines.
+     */
+    stackCommands: {
+        typescript: { build: 'pnpm build', test: 'pnpm test', lint: 'pnpm lint', typecheck: 'pnpm typecheck', dev: 'pnpm dev' },
+        node: { build: 'pnpm build', test: 'pnpm test', lint: 'pnpm lint', typecheck: 'pnpm typecheck', dev: 'pnpm dev' },
+        python: { build: 'uv build', test: 'uv run pytest', lint: 'uv run ruff check .', typecheck: 'uv run mypy .', dev: 'uv run dev' },
+        dotnet: { build: 'dotnet build', test: 'dotnet test', lint: 'dotnet format --verify-no-changes', typecheck: 'dotnet build', dev: 'dotnet watch run' },
+        go: { build: 'go build ./...', test: 'go test ./...', lint: 'golangci-lint run', typecheck: 'go vet ./...', dev: 'go run ./cmd' },
+        rust: { build: 'cargo build', test: 'cargo test', lint: 'cargo clippy', typecheck: 'cargo check', dev: 'cargo run' },
+        java: { build: './gradlew build', test: './gradlew test', lint: './gradlew check', typecheck: './gradlew compileJava', dev: './gradlew bootRun' },
+        polyglot: { build: 'pnpm -r build', test: 'pnpm -r test', lint: 'pnpm -r lint', typecheck: 'pnpm -r typecheck', dev: 'pnpm dev' },
+    },
+};
+function env(key) {
+    const v = process.env[key];
+    return v === undefined || v === '' ? undefined : v;
+}
+function num(key, fallback) {
+    const raw = env(key);
+    if (raw === undefined)
+        return fallback;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed))
+        throw new Error(`${key} must be numeric, got "${raw}"`);
+    return parsed;
+}
+function list(key, fallback) {
+    const raw = env(key);
+    return raw === undefined ? [...fallback] : raw.split(',').map((s) => s.trim()).filter(Boolean);
+}
+export function loadConfig() {
+    const groundplanHome = env('GROUNDPLAN_HOME') ?? (discovered ??= discoverHome(HERE));
+    const resolved = {
+        ...defaults,
+        groundplanHome,
+        catalogDir: env('GROUNDPLAN_CATALOG_DIR') ?? defaults.catalogDir,
+        templatesDir: env('GROUNDPLAN_TEMPLATES_DIR') ?? defaults.templatesDir,
+        adaptersDir: env('GROUNDPLAN_ADAPTERS_DIR') ?? defaults.adaptersDir,
+        registryDir: env('GROUNDPLAN_REGISTRY_DIR') ?? defaults.registryDir,
+        blueprintFilesDir: env('GROUNDPLAN_BLUEPRINT_FILES_DIR') ?? defaults.blueprintFilesDir,
+        defaultAdapters: list('GROUNDPLAN_DEFAULT_ADAPTERS', defaults.defaultAdapters),
+        protectedPaths: list('GROUNDPLAN_PROTECTED_PATHS', defaults.protectedPaths),
+        adapterVerificationDays: num('GROUNDPLAN_ADAPTER_VERIFICATION_DAYS', defaults.adapterVerificationDays),
+        maxFilesPerPlan: num('GROUNDPLAN_MAX_FILES', defaults.maxFilesPerPlan),
+        maxFileBytes: num('GROUNDPLAN_MAX_FILE_BYTES', defaults.maxFileBytes),
+        postApplyTimeoutMs: num('GROUNDPLAN_POST_APPLY_TIMEOUT_MS', defaults.postApplyTimeoutMs),
+    };
+    return {
+        ...resolved,
+        paths: {
+            catalog: path.join(groundplanHome, resolved.catalogDir),
+            templates: path.join(groundplanHome, resolved.templatesDir),
+            adapters: path.join(groundplanHome, resolved.adaptersDir),
+            registry: path.join(groundplanHome, resolved.registryDir),
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAEnF;;;;;;;;;;;GAWG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,SAAS,CAAC;QACR,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,uFAAuF;IACvF,0FAA0F;IAC1F,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,+FAA+F;AAC/F,IAAI,UAA8B,CAAC;AAEnC,4EAA4E;AAC5E,MAAM,QAAQ,GAAG;IACf,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,WAAW;IACzB,WAAW,EAAE,UAAU;IACvB,WAAW,EAAE,UAAU;IACvB,8FAA8F;IAC9F,iBAAiB,EAAE,OAAO;IAE1B,iEAAiE;IACjE,eAAe,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC;IAErE;;;;OAIG;IACH,uBAAuB,EAAE,GAAG;IAE5B;;;;OAIG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,SAAS,CAAC;IAE7F,sEAAsE;IACtE,eAAe,EAAE,IAAI;IACrB,YAAY,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAC7B,kBAAkB,EAAE,OAAO;IAE3B;;;OAGG;IACH,aAAa,EAAE;QACb,UAAU,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,EAAE;QACvH,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,EAAE;QACjH,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,qBAAqB,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE;QAChI,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,mCAAmC,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE,kBAAkB,EAAE;QACrJ,EAAE,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,EAAE;QACjI,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,EAAE;QACpH,IAAI,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,uBAAuB,EAAE,GAAG,EAAE,mBAAmB,EAAE;QACjJ,QAAQ,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,mBAAmB,EAAE,GAAG,EAAE,UAAU,EAAE;KAClI;CACO,CAAC;AAGX,SAAS,GAAG,CAAC,GAAW;IACtB,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,GAAG,CAAC,GAAW,EAAE,QAAgB;IACxC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,0BAA0B,GAAG,GAAG,CAAC,CAAC;IACtF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,IAAI,CAAC,GAAW,EAAE,QAA2B;IACpD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjG,CAAC;AAgCD,MAAM,UAAU,UAAU;IACxB,MAAM,cAAc,GAAG,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACrF,MAAM,QAAQ,GAAG;QACf,GAAG,QAAQ;QACX,cAAc;QACd,UAAU,EAAE,GAAG,CAAC,wBAAwB,CAAC,IAAI,QAAQ,CAAC,UAAU;QAChE,YAAY,EAAE,GAAG,CAAC,0BAA0B,CAAC,IAAI,QAAQ,CAAC,YAAY;QACtE,WAAW,EAAE,GAAG,CAAC,yBAAyB,CAAC,IAAI,QAAQ,CAAC,WAAW;QACnE,WAAW,EAAE,GAAG,CAAC,yBAAyB,CAAC,IAAI,QAAQ,CAAC,WAAW;QACnE,iBAAiB,EAAE,GAAG,CAAC,gCAAgC,CAAC,IAAI,QAAQ,CAAC,iBAAiB;QACtF,eAAe,EAAE,IAAI,CAAC,6BAA6B,EAAE,QAAQ,CAAC,eAAe,CAAC;QAC9E,cAAc,EAAE,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC,cAAc,CAAC;QAC3E,uBAAuB,EAAE,GAAG,CAAC,sCAAsC,EAAE,QAAQ,CAAC,uBAAuB,CAAC;QACtG,eAAe,EAAE,GAAG,CAAC,sBAAsB,EAAE,QAAQ,CAAC,eAAe,CAAC;QACtE,YAAY,EAAE,GAAG,CAAC,2BAA2B,EAAE,QAAQ,CAAC,YAAY,CAAC;QACrE,kBAAkB,EAAE,GAAG,CAAC,kCAAkC,EAAE,QAAQ,CAAC,kBAAkB,CAAC;KACzF,CAAC;IAEF,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE;YACL,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,UAAU,CAAC;YACvD,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,YAAY,CAAC;YAC3D,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,WAAW,CAAC;YACzD,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,WAAW,CAAC;SAC1D;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from './schema.js';
+export * from './config.js';
+export * from './tokens.js';
+export * from './condition.js';
+export * from './resolve.js';
+export * from './loader.js';
+export * from './plan.js';
+export * from './apply.js';
+export * from './recommend.js';
+export * from './intent.js';
+export * from './agentkit.js';
+export * from './adapters.js';
+export * from './python-requirements.js';
+export * from './license.js';
+export * from './merge.js';

package/dist/index.js

@@ -0,0 +1,16 @@
+export * from './schema.js';
+export * from './config.js';
+export * from './tokens.js';
+export * from './condition.js';
+export * from './resolve.js';
+export * from './loader.js';
+export * from './plan.js';
+export * from './apply.js';
+export * from './recommend.js';
+export * from './intent.js';
+export * from './agentkit.js';
+export * from './adapters.js';
+export * from './python-requirements.js';
+export * from './license.js';
+export * from './merge.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/intent.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Intent inference — "understand what will be built" before recommending anything.
+ *
+ * Reads a free-text project description and derives the architecture characteristics
+ * that actually matter for it, so the user does not have to know the vocabulary of
+ * quality attributes to get an optimal answer.
+ *
+ * Deterministic by design: every inference is traceable to a matched signal, and the result
+ * is auditable. There is no model in this path and no network call — a recommendation is
+ * reproducible from the description alone, and reviewable by reading the signal that fired.
+ */
+import type { Characteristic, Stack } from './schema.js';
+export interface Signal {
+    id: string;
+    /** Matched against the lowercased description. */
+    patterns: RegExp[];
+    /** Characteristic weight deltas applied when this signal fires. */
+    weights: Partial<Record<Characteristic, number>>;
+    /** Architecture families this signal makes relevant. */
+    family?: 'application' | 'system' | 'frontend' | 'data' | 'ai';
+    /** Layers the generated repo almost certainly needs. */
+    implies?: string[];
+    because: string;
+}
+/**
+ * Signal table. Weights are deltas, not absolutes — several signals compound, which is
+ * what lets "high-traffic multi-tenant SaaS with audit requirements" score differently
+ * from "internal admin tool".
+ */
+export declare const SIGNALS: Signal[];
+export interface TeamSignal {
+    patterns: RegExp[];
+    size: number;
+}
+export interface Intent {
+    priorities: Partial<Record<Characteristic, number>>;
+    family?: Signal['family'];
+    stack?: Stack;
+    teamSize?: number;
+    impliedLayers: string[];
+    matched: {
+        signal: string;
+        because: string;
+    }[];
+    /** 0..1 — how much of the description the signal table actually explained. */
+    confidence: number;
+}
+/**
+ * Infer what to build from prose. Never throws on unrecognized input; an empty match
+ * set returns zero confidence so the caller knows to fall back to the interview.
+ */
+export declare function inferIntent(description: string): Intent;

package/dist/intent.js

@@ -0,0 +1,220 @@
+/**
+ * Signal table. Weights are deltas, not absolutes — several signals compound, which is
+ * what lets "high-traffic multi-tenant SaaS with audit requirements" score differently
+ * from "internal admin tool".
+ */
+export const SIGNALS = [
+    {
+        id: 'crud-admin',
+        patterns: [/\b(admin|back[- ]?office|internal tool|dashboard|crud)\b/],
+        weights: { simplicity: 4, maintainability: 2, cost: 3, scalability: -2 },
+        family: 'application',
+        implies: ['db', 'auth'],
+        because: 'CRUD-dominant tools are punished by ceremony and rarely need to scale out',
+    },
+    {
+        id: 'high-traffic',
+        patterns: [/\b(high[- ]traffic|millions? of (users|requests)|viral|web[- ]?scale|spike)\b/],
+        weights: { scalability: 5, elasticity: 4, responsiveness: 3, simplicity: -2 },
+        family: 'system',
+        implies: ['cache', 'observability'],
+        because: 'stated load makes scalability and elasticity dominant',
+    },
+    {
+        id: 'realtime',
+        patterns: [/\b(real[- ]?time|websocket|live (updates|feed)|streaming|chat|collaborative)\b/],
+        weights: { responsiveness: 5, 'fault-tolerance': 3, scalability: 3 },
+        family: 'system',
+        implies: ['queue', 'observability'],
+        because: 'latency is the product, so responsiveness outranks simplicity',
+    },
+    {
+        id: 'regulated',
+        // Prefix alternatives take \w* — a trailing \b would reject the very words they target.
+        patterns: [/\b(hipaa|pci|gdpr|sox|regulat\w*|complian\w*|audit\w*|financial|banking|insurance|medical|health)\b/],
+        weights: { testability: 5, maintainability: 4, 'fault-tolerance': 4, evolvability: 2, simplicity: -1 },
+        family: 'application',
+        implies: ['audit-log', 'security', 'observability'],
+        because: 'regulated domains need business rules provable in isolation',
+    },
+    {
+        id: 'complex-domain',
+        patterns: [/\b(workflow\w*|underwrit\w*|logistics|pricing|billing|scheduling|inventory|trading|settlement)\b/],
+        weights: { maintainability: 4, testability: 4, evolvability: 3, simplicity: -2 },
+        family: 'application',
+        implies: ['db'],
+        because: 'real invariants justify a modelled domain instead of a thin service layer',
+    },
+    {
+        id: 'mvp',
+        patterns: [/\b(mvp|prototype|proof[- ]of[- ]concept|poc|experiment|hackathon|demo|validate)\b/],
+        weights: { simplicity: 5, cost: 4, deployability: 2, scalability: -3, abstraction: -3 },
+        implies: [],
+        because: 'pre-product-market-fit, unused flexibility is pure cost',
+    },
+    {
+        id: 'multi-tenant',
+        patterns: [/\b(multi[- ]?tenant|saas|per[- ]customer|white[- ]?label|tenant isolation)\b/],
+        weights: { scalability: 3, maintainability: 3, evolvability: 3, 'fault-tolerance': 3 },
+        family: 'system',
+        implies: ['db', 'auth', 'observability'],
+        because: 'tenant isolation and blast-radius control shape the topology',
+    },
+    {
+        id: 'many-integrations',
+        patterns: [/\b(integrat\w*|third[- ]?party|webhook\w*|connector\w*|sync with|payment (gateway|provider)|crm|erp)\b/],
+        weights: { evolvability: 4, testability: 4, interoperability: 4, 'fault-tolerance': 3 },
+        family: 'application',
+        implies: ['queue', 'observability'],
+        because: 'each external system needs a swappable, independently testable boundary',
+    },
+    {
+        id: 'event-heavy',
+        patterns: [/\b(event[- ]driven|pub[- ]?sub|message queue|kafka|rabbitmq|async processing|choreograph)\b/],
+        weights: { scalability: 4, 'fault-tolerance': 4, evolvability: 4, simplicity: -3 },
+        family: 'system',
+        implies: ['queue', 'observability'],
+        because: 'explicit async decoupling is already the stated design',
+    },
+    {
+        id: 'ai-agent',
+        patterns: [/\b(ai agent|llm|rag|chatbot|copilot|semantic search|embedding|vector (db|search)|prompt)\b/],
+        weights: { evolvability: 4, testability: 4, cost: 4, responsiveness: 3 },
+        family: 'ai',
+        implies: ['observability', 'evals'],
+        because: 'LLM systems are unpredictable in cost and quality without evals and tracing',
+    },
+    {
+        id: 'data-pipeline',
+        patterns: [/\b(etl|elt|data (pipeline|warehouse|lake)|analytics|batch (job|process)|ingest)\b/],
+        weights: { maintainability: 4, 'fault-tolerance': 4, scalability: 4, cost: 3 },
+        family: 'data',
+        implies: ['observability'],
+        because: 'replayability and lineage dominate pipeline design',
+    },
+    {
+        id: 'frontend-heavy',
+        patterns: [/\b(design system|component library|spa|landing page|marketing site|storefront|ui[- ]heavy)\b/],
+        weights: { maintainability: 4, evolvability: 3, responsiveness: 4, simplicity: 2 },
+        family: 'frontend',
+        implies: ['testing-e2e'],
+        because: 'frontend cost concentrates in structure and change safety, not throughput',
+    },
+    {
+        id: 'mobile-backend',
+        patterns: [/\b(mobile app|ios|android|react native|flutter|offline[- ]first)\b/],
+        weights: { interoperability: 4, responsiveness: 4, evolvability: 3 },
+        family: 'system',
+        implies: ['auth', 'api-versioning'],
+        because: 'shipped clients cannot be force-upgraded, so contracts must stay stable',
+    },
+    {
+        id: 'legacy-migration',
+        patterns: [/\b(migrat\w*|legacy|rewrite|modernis\w*|moderniz\w*|strangler|replatform)\b/],
+        weights: { evolvability: 5, testability: 4, interoperability: 4, deployability: 3 },
+        family: 'system',
+        implies: ['observability', 'testing-contract'],
+        because: 'incremental replacement needs seams and a safety net above all else',
+    },
+    {
+        id: 'cost-sensitive',
+        patterns: [/\b(cheap|low[- ]cost|budget|bootstrap|side project|solo|indie)\b/],
+        weights: { cost: 5, simplicity: 4, deployability: 2, scalability: -2 },
+        implies: [],
+        because: 'infrastructure spend is a hard constraint, not a preference',
+    },
+    {
+        id: 'high-availability',
+        patterns: [/\b(high[- ]availability|99\.9|uptime|mission[- ]critical|zero[- ]downtime|failover|disaster recovery)\b/],
+        weights: { 'fault-tolerance': 5, deployability: 4, scalability: 3, simplicity: -2 },
+        family: 'system',
+        implies: ['observability', 'health-checks'],
+        because: 'stated uptime targets force redundancy into the topology',
+    },
+];
+/** Team size stated in prose beats a guess, and it hard-gates several architectures. */
+const TEAM_SIGNALS = [
+    { patterns: [/\b(solo|just me|myself|one[- ]person|alone)\b/], size: 1 },
+    { patterns: [/\b(small team|two of us|couple of (devs|engineers)|startup team)\b/], size: 4 },
+    { patterns: [/\b(\d+)\s*(engineers?|devs?|developers?)\b/], size: 0 },
+    { patterns: [/\b(enterprise|large (team|org)|multiple teams|several teams)\b/], size: 40 },
+];
+const STACK_SIGNALS = [
+    { patterns: [/\b(next\.?js|react|remix|vite|typescript frontend|tailwind)\b/], stack: 'typescript' },
+    { patterns: [/\b(fastapi|django|flask|python|pandas|pytorch|langchain)\b/], stack: 'python' },
+    // `\.net` cannot be preceded by \b — "." is not a word character.
+    { patterns: [/(?:^|[^\w.])\.net\b|\b(dotnet|c#|asp\.?net|blazor|aspire|entity framework)\b/], stack: 'dotnet' },
+    { patterns: [/\b(nestjs|express|node\.?js backend|fastify)\b/], stack: 'node' },
+    { patterns: [/\b(golang|\bgo\b service)\b/], stack: 'go' },
+    { patterns: [/\b(rust|axum|actix)\b/], stack: 'rust' },
+];
+/**
+ * Infer what to build from prose. Never throws on unrecognized input; an empty match
+ * set returns zero confidence so the caller knows to fall back to the interview.
+ */
+export function inferIntent(description) {
+    const text = description.toLowerCase();
+    const priorities = {};
+    const matched = [];
+    const impliedLayers = new Set();
+    const familyVotes = new Map();
+    for (const signal of SIGNALS) {
+        if (!signal.patterns.some((pattern) => pattern.test(text)))
+            continue;
+        matched.push({ signal: signal.id, because: signal.because });
+        for (const [characteristic, delta] of Object.entries(signal.weights)) {
+            const key = characteristic;
+            priorities[key] = (priorities[key] ?? 0) + delta;
+        }
+        for (const layer of signal.implies ?? [])
+            impliedLayers.add(layer);
+        if (signal.family)
+            familyVotes.set(signal.family, (familyVotes.get(signal.family) ?? 0) + 1);
+    }
+    // Clamp into the 0..5 range the recommender expects; negatives mean "explicitly not a goal".
+    for (const key of Object.keys(priorities)) {
+        priorities[key] = Math.max(0, Math.min(5, priorities[key]));
+        if (priorities[key] === 0)
+            delete priorities[key];
+    }
+    return {
+        priorities,
+        family: topVote(familyVotes),
+        stack: detectStack(text),
+        teamSize: detectTeamSize(text),
+        impliedLayers: [...impliedLayers],
+        matched,
+        confidence: Math.min(1, matched.length / 3),
+    };
+}
+function topVote(votes) {
+    let best;
+    let bestCount = 0;
+    for (const [key, count] of votes) {
+        if (count > bestCount) {
+            best = key;
+            bestCount = count;
+        }
+    }
+    return best;
+}
+function detectStack(text) {
+    for (const { patterns, stack } of STACK_SIGNALS) {
+        if (patterns.some((pattern) => pattern.test(text)))
+            return stack;
+    }
+    return undefined;
+}
+function detectTeamSize(text) {
+    for (const { patterns, size } of TEAM_SIGNALS) {
+        for (const pattern of patterns) {
+            const match = pattern.exec(text);
+            if (!match)
+                continue;
+            // A stated number always wins over the phrase bucket it was matched by.
+            return size === 0 ? Number(match[1]) : size;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=intent.js.map