@opengroundplan/core 0.1.1 → 0.2.0

package/dist/variables.js

@@ -0,0 +1,37 @@
+/**
+ * The one place blueprint variables become values. The interview, the autoplanner, and the
+ * generate harness all resolve through here — the same loop lived in three files and was three
+ * chances for the CLI and the library to disagree about what a repo contains.
+ *
+ * Every variable takes its declared default. A variable gated off on this stack by `when` may
+ * still be named by a template on another stack, so it is deferred and defaulted rather than
+ * left unset — an unresolved token fails generation, a stale default never renders.
+ */
+import { test as testCondition } from './condition.js';
+export function resolveVariableDefaults(blueprints, context, overrides = {}) {
+    const vars = { ...overrides };
+    const missing = [];
+    const deferred = [];
+    for (const blueprint of blueprints) {
+        for (const variable of blueprint.variables) {
+            if (variable.name in vars)
+                continue;
+            if (!testCondition(variable.when, { ...context, ...vars })) {
+                deferred.push(variable);
+                continue;
+            }
+            if (variable.default === undefined) {
+                missing.push(`${blueprint.id}.${variable.name}`);
+                continue;
+            }
+            vars[variable.name] = variable.default;
+        }
+    }
+    for (const variable of deferred) {
+        if (!(variable.name in vars) && variable.default !== undefined) {
+            vars[variable.name] = variable.default;
+        }
+    }
+    return { vars, missing };
+}
+//# sourceMappingURL=variables.js.map

package/dist/variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.js","sourceRoot":"","sources":["../src/variables.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAC;AASvD,MAAM,UAAU,uBAAuB,CACrC,UAAuB,EACvB,OAAgC,EAChC,YAAqC,EAAE;IAEvC,MAAM,IAAI,GAA4B,EAAE,GAAG,SAAS,EAAE,CAAC;IACvD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAE5C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YAC3C,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI;gBAAE,SAAS;YACpC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC3D,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC"}

package/dist/verification.d.ts

@@ -0,0 +1,23 @@
+import type { GroundplanConfig } from './config.js';
+export interface Check {
+    name: string;
+    command: string;
+}
+export interface CheckResult extends Check {
+    ok: boolean;
+    /** Combined stdout+stderr, trimmed — empty when the check could not start. */
+    output: string;
+}
+/**
+ * The ordered checks for a stack: typecheck → lint → build → test, skipping any the stack does
+ * not declare. Install is the caller's concern (the generated repo's postApply handles it).
+ */
+export declare function verificationPlan(stack: string, config: GroundplanConfig): Check[];
+export interface RunOptions {
+    timeoutMs?: number;
+    onProgress?: (name: string) => void;
+    /** Stop at the first failing check (the default) rather than running them all. */
+    stopOnFailure?: boolean;
+}
+/** Run each check in `cwd`, capturing its result. Never throws — a failed spawn is a failed check. */
+export declare function runChecks(cwd: string, checks: Check[], config: GroundplanConfig, opts?: RunOptions): Promise<CheckResult[]>;

package/dist/verification.js

@@ -0,0 +1,61 @@
+/**
+ * Post-generation verification. A generated repo is only correct if it builds — the rule this
+ * project holds itself to — so this runs the stack's own checks against the output and reports
+ * what passed. The plan is derived from `config.stackCommands` (one place, no inlined command),
+ * and the runner captures each result; a failing check carries its output so an agent, or a
+ * person, can fix it. The self-fix loop lives above this: this layer reports, it does not edit.
+ */
+import { spawn } from 'node:child_process';
+/**
+ * The ordered checks for a stack: typecheck → lint → build → test, skipping any the stack does
+ * not declare. Install is the caller's concern (the generated repo's postApply handles it).
+ */
+export function verificationPlan(stack, config) {
+    const cmds = config.stackCommands[stack];
+    if (!cmds)
+        return [];
+    const ordered = [
+        ['typecheck', cmds.typecheck],
+        ['lint', cmds.lint],
+        ['build', cmds.build],
+        ['test', cmds.test],
+    ];
+    return ordered.filter((c) => Boolean(c[1])).map(([name, command]) => ({ name, command }));
+}
+/** Run each check in `cwd`, capturing its result. Never throws — a failed spawn is a failed check. */
+export async function runChecks(cwd, checks, config, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? config.postApplyTimeoutMs;
+    const stopOnFailure = opts.stopOnFailure ?? true;
+    const results = [];
+    for (const check of checks) {
+        opts.onProgress?.(check.name);
+        const result = await runOne(cwd, check, timeoutMs);
+        results.push(result);
+        if (!result.ok && stopOnFailure)
+            break;
+    }
+    return results;
+}
+function runOne(cwd, check, timeoutMs) {
+    return new Promise((resolve) => {
+        // shell:true so a declared command line ("pnpm run build") runs as written; the command
+        // comes from config.stackCommands, never from user input.
+        const child = spawn(check.command, { cwd, shell: true, stdio: ['ignore', 'pipe', 'pipe'] });
+        let output = '';
+        const capture = (buf) => {
+            output += buf.toString();
+        };
+        child.stdout?.on('data', capture);
+        child.stderr?.on('data', capture);
+        const timer = setTimeout(() => child.kill('SIGKILL'), timeoutMs);
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({ ...check, ok: false, output: `could not start: ${err.message}` });
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            resolve({ ...check, ok: code === 0, output: output.trim().slice(-4000) });
+        });
+    });
+}
+//# sourceMappingURL=verification.js.map

package/dist/verification.js.map

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

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@opengroundplan/core",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "The Groundplan engine and catalog: composes a repository from templates, brands it, and wires it for every AI coding tool.",
   "license": "MIT",
   "author": "Groundplan contributors",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/groundplan/groundplan.git",
+    "url": "git+https://github.com/groundplan/opengroundplan.git",
     "directory": "packages/core"
   },
-  "homepage": "https://github.com/groundplan/groundplan#readme",
-  "bugs": "https://github.com/groundplan/groundplan/issues",
+  "homepage": "https://github.com/groundplan/opengroundplan#readme",
+  "bugs": "https://github.com/groundplan/opengroundplan/issues",
   "keywords": [
     "scaffolding",
     "templates",
@@ -57,5 +57,8 @@
     "glob": "^11.0.0",
     "yaml": "^2.6.1",
     "zod": "^3.24.1"
+  },
+  "optionalDependencies": {
+    "@anthropic-ai/sdk": "^0.112.0"
   }
 }

package/templates/bases/fastapi-service/blueprint.yaml

@@ -33,9 +33,8 @@ supportsArchitectures:
   - cqrs
   - microservices
   - serverless
-  - llm-workflow
-  - agentic-tool-loop
-  - multi-agent
+  # AI-agent architectures (llm-workflow, agentic-tool-loop, multi-agent, rag-hybrid) belong to
+  # python-ai-agent, which ships the llm-runtime they assume. This is a plain HTTP service base.
   - medallion
   - mvc-mvvm
   - pipes-and-filters

package/templates/layers/auth-jwt/blueprint.yaml

@@ -1,6 +1,9 @@
 id: auth-jwt
 kind: layer
 name: Self-issued JWT auth
+# One auth strategy per repo; self-issued JWT is the default when a project implies auth.
+choiceSet: auth
+choiceDefault: true
 description: >-
   First-party authentication: the service signs its own short-lived HS256 access
   tokens, hashes passwords with Argon2id, and rotates opaque refresh tokens with

package/templates/layers/auth-oidc/blueprint.yaml

@@ -1,6 +1,7 @@
 id: auth-oidc
 kind: layer
 name: OIDC / OAuth2 authentication
+choiceSet: auth
 description: >-
   Standards-compliant OpenID Connect wiring. Browser stacks get Authorization Code + PKCE
   login with an encrypted session cookie; API stacks get bearer-token validation against the

package/templates/layers/db-mongo/blueprint.yaml

@@ -1,6 +1,7 @@
 id: db-mongo
 kind: layer
 name: MongoDB
+choiceSet: database
 description: >-
   MongoDB persistence adapter: pooled client, environment-driven settings, idempotent index
   declarations, health check, and a dev single-node replica set for transactions and change streams.

package/templates/layers/db-postgres/blueprint.yaml

@@ -6,6 +6,9 @@
 id: db-postgres
 kind: layer
 name: PostgreSQL
+# One primary datastore per repo; postgres is the default when a project implies a database.
+choiceSet: database
+choiceDefault: true
 description: Pooled PostgreSQL access, plain-SQL migrations, and a local server, configured entirely from the environment.
 tags:
   - database

package/templates/layers/db-sqlite/blueprint.yaml

@@ -1,6 +1,7 @@
 id: db-sqlite
 kind: layer
 name: SQLite
+choiceSet: database
 description: Embedded SQLite persistence — connection, pragmas, plain-SQL migrations, health probe. For local, single-node, and small workloads.
 tags: [database, sqlite, persistence, embedded, local-first]