@opengroundplan/core 0.1.1

package/dist/schema.js

@@ -0,0 +1,307 @@
+/**
+ * Groundplan contracts. Every catalog entry, blueprint, adapter, and registry item
+ * validates against these. Templates are data — this file is the only place
+ * that defines what that data may look like.
+ */
+import { z } from 'zod';
+/* ── primitives ───────────────────────────────────────────────────────────── */
+export const Id = z.string().regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, 'must be kebab-case');
+export const Stack = z.enum([
+    'typescript',
+    'python',
+    'dotnet',
+    'node',
+    'go',
+    'rust',
+    'java',
+    'polyglot',
+]);
+export const Complexity = z.enum(['low', 'medium', 'high', 'very-high']);
+/** Richards' architecture characteristics — the axes a recommendation scores on. */
+export const Characteristic = z.enum([
+    'maintainability',
+    'testability',
+    'deployability',
+    'simplicity',
+    'scalability',
+    'elasticity',
+    'responsiveness',
+    'fault-tolerance',
+    'evolvability',
+    'abstraction',
+    'interoperability',
+    'cost',
+]);
+/** Conditions are evaluated against the resolved answer set, never eval'd as JS. */
+export const Condition = z.string().min(1);
+/* ── catalog: architectures ───────────────────────────────────────────────── */
+export const ArchitectureEntry = z.object({
+    id: Id,
+    name: z.string(),
+    family: z.enum(['application', 'system', 'frontend', 'data', 'ai']),
+    oneLine: z.string(),
+    bestFor: z.array(z.string()).min(1),
+    avoidWhen: z.array(z.string()).min(1),
+    complexity: Complexity,
+    teamSize: z.object({ min: z.number().int(), max: z.number().int() }),
+    /** 1–5 per characteristic; drives ranking in the decision engine. */
+    scores: z.record(Characteristic, z.number().int().min(1).max(5)),
+    stackFit: z.record(Stack, z.enum(['excellent', 'good', 'workable', 'awkward', 'n/a'])),
+    keyTradeoff: z.string(),
+    /** Blueprint that materializes this architecture's folder layout. */
+    overlay: Id.optional(),
+    /**
+     * Why this architecture ships no layout. Some are patterns you apply *inside* a layout —
+     * DDD's tactical patterns live in whatever folders the chosen architecture created — so an
+     * overlay would be an invention, not a materialisation.
+     *
+     * Exactly one of `overlay` or `guidance` is required. Neither used to be, which let an
+     * architecture ship with no layout and no reason, indistinguishable from an unfinished one.
+     */
+    guidance: z.string().min(40).optional(),
+    sources: z.array(z.string().url()).min(1),
+}).refine((entry) => Boolean(entry.overlay) !== Boolean(entry.guidance), {
+    message: 'an architecture needs exactly one of `overlay` (the blueprint that creates its layout) ' +
+        'or `guidance` (why it deliberately creates none)',
+    path: ['overlay'],
+});
+/* ── variables ────────────────────────────────────────────────────────────── */
+export const Variable = z.object({
+    name: z.string().regex(/^[a-zA-Z][a-zA-Z0-9]*$/),
+    prompt: z.string(),
+    type: z.enum(['string', 'boolean', 'number', 'select', 'multiselect']),
+    choices: z.array(z.object({ value: z.string(), label: z.string() })).optional(),
+    default: z.unknown().optional(),
+    required: z.boolean().default(false),
+    /** Only ask when this holds — keeps the interview short. */
+    when: Condition.optional(),
+});
+/* ── blueprints (base / layer / architecture overlay) ─────────────────────── */
+/**
+ * `merge` folds a fragment into a file another blueprint owns. The format is inferred from
+ * the destination — JSON, TOML, MSBuild XML, or go.mod — so a declared strategy cannot
+ * disagree with the file it targets. `merge-json` is the original name, kept working.
+ */
+export const MergeStrategy = z.enum(['skip', 'overwrite', 'merge', 'merge-json', 'append', 'fail']);
+export const FileRule = z.object({
+    from: z.string(),
+    to: z.string().default('.'),
+    when: Condition.optional(),
+    /** Copy verbatim — for binaries and files whose syntax collides with the tokens. */
+    raw: z.boolean().default(false),
+    onConflict: MergeStrategy.default('fail'),
+});
+/**
+ * Licenses we may copy and adapt code from. Permissive only — anything copyleft would
+ * propagate its terms into every repository Groundplan generates, including commercial ones.
+ * An unlicensed repo is "all rights reserved", not "free"; it is not on this list.
+ */
+export const VENDORABLE_LICENSES = [
+    'MIT',
+    'Apache-2.0',
+    'BSD-2-Clause',
+    'BSD-3-Clause',
+    'ISC',
+    'Unlicense',
+    '0BSD',
+    'CC0-1.0',
+];
+/** Apache-2.0 and BSD require the copyright notice to travel with the code. */
+export const ATTRIBUTION_REQUIRED = ['Apache-2.0', 'BSD-2-Clause', 'BSD-3-Clause'];
+/**
+ * A post-apply command, which `apply` runs through a shell so steps can chain with `&&`.
+ *
+ * Tokens are rejected rather than rendered. Rendering one would put a user-supplied value —
+ * a solution name is free text — inside a shell string, so `x; rm -rf ~` would execute. That
+ * makes "postApply is never rendered" a security boundary, and this refusal is what enforces
+ * it: a contributor who adds a token here gets a catalog error, not a shell injection.
+ * Anything needing a variable belongs in a template file, which is rendered safely.
+ */
+export const ShellStep = z
+    .string()
+    .min(1)
+    .refine((run) => !/\{\{|__[A-Za-z]/.test(run), {
+    message: 'postApply commands are never token-rendered, so a token here would silently stay literal. ' +
+        'Put the variable in a template file, or have the step read it from a generated file.',
+});
+export const SourceAttribution = z.object({
+    name: z.string(),
+    url: z.string().url(),
+    license: z.enum(VENDORABLE_LICENSES),
+    /** What was actually taken. "Inspired by" needs no attribution; copied code does. */
+    adapted: z.string(),
+});
+export const Blueprint = z.object({
+    id: Id,
+    kind: z.enum(['base', 'layer', 'architecture', 'agent-kit']),
+    name: z.string(),
+    description: z.string(),
+    /** Upstream code this blueprint adapts. Drives NOTICE generation in the output repo. */
+    sources: z.array(SourceAttribution).default([]),
+    /**
+     * What this stack's toolchain is actually invoked with. Declared by bases and read by the
+     * agent-kit, so AGENTS.md carries real commands instead of asking the user to retype what
+     * the template already knows.
+     */
+    commands: z
+        .object({
+        build: z.string(),
+        test: z.string(),
+        lint: z.string(),
+        typecheck: z.string().optional(),
+        dev: z.string().optional(),
+    })
+        .optional(),
+    stack: Stack.optional(),
+    tags: z.array(z.string()).default([]),
+    /** Dependency algebra — resolved at plan time so broken combos never reach disk. */
+    requires: z.array(Id).default([]),
+    conflicts: z.array(Id).default([]),
+    provides: z.array(Id).default([]),
+    supportsArchitectures: z.array(Id).default([]),
+    /**
+     * Mutually exclusive alternatives, declared once instead of as pairwise conflicts.
+     * Six databases need fifteen conflict pairs kept in sync; they need one choiceSet.
+     * The CLI renders a set as pick-one rather than as checkboxes.
+     */
+    choiceSet: Id.optional(),
+    /** Bases whose framework packages this layer may import without declaring them itself. */
+    peerProvidedBy: z.array(Id).default([]),
+    /** Preselected option when the user does not choose within this set. */
+    choiceDefault: z.boolean().default(false),
+    variables: z.array(Variable).default([]),
+    files: z.array(FileRule).default([]),
+    /** Shell steps run after apply; each declares why it is safe to run unattended. */
+    postApply: z
+        .array(z.object({ run: ShellStep, when: Condition.optional(), optional: z.boolean().default(false) }))
+        .default([]),
+});
+/* ── adapters: one per AI coding tool ─────────────────────────────────────── */
+export const AdapterCapability = z.enum([
+    'instructions',
+    'nested-instructions',
+    'glob-scoped-rules',
+    'slash-commands',
+    'subagents',
+    'hooks',
+    'skills',
+    'mcp',
+]);
+/**
+ * How to run a tool headlessly, so delegation is an executed command rather than a routing
+ * table nobody acts on. Flags must be verified from the vendor's own docs — an
+ * approximately-right flag produces a delegation that silently does nothing.
+ */
+export const Invocation = z.object({
+    binary: z.string().min(1),
+    /** `{prompt}` and `{model}` are substituted at dispatch; everything else is literal. */
+    args: z.array(z.string()).min(1),
+    promptVia: z.enum(['arg', 'stdin']).default('arg'),
+    /**
+     * Args appended when the caller opts into unattended file edits. Every one of these means
+     * "edit files without asking". An empty array is a valid, meaningful answer — Amp never
+     * asks, so inventing a flag for it would misdescribe the tool.
+     */
+    autoApprove: z.array(z.string()).default([]),
+    modelFlag: z.array(z.string()).default([]),
+    /** Liveness probe, run with a short cap. */
+    detect: z.array(z.string()).min(1).default(['--version']),
+    /** Printed when no preferred tool is installed, so the failure is actionable (ADR 0007 §6). */
+    install: z.string().min(1),
+    /**
+     * When these flags were last checked against the vendor's own documentation. Required, so
+     * "verified" is a date rather than a claim: a URL alone says someone looked once, and gives
+     * no way to tell whether that was last week or two years ago. `doctor` reports entries older
+     * than the window in config.
+     */
+    verifiedOn: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'must be YYYY-MM-DD'),
+    /** Vendor documentation for these exact flags. The field that rots fastest (ADR 0007 §4). */
+    verified: z.string().url(),
+    /**
+     * Set when the vendor has announced end of support. The adapter stays — removing it breaks
+     * working setups — and the note explains the scope (ADR 0007 §9).
+     */
+    deprecated: z
+        .object({
+        since: z.string(),
+        note: z.string(),
+        successor: Id.optional(),
+        source: z.string().url(),
+    })
+        .optional(),
+});
+export const Adapter = z.object({
+    id: Id,
+    name: z.string(),
+    /** Present only for tools with a verified headless mode; absent means "cannot delegate to". */
+    invoke: Invocation.optional(),
+    /** True when the tool reads AGENTS.md natively — no wrapper file needed. */
+    readsAgentsMd: z.boolean(),
+    capabilities: z.array(AdapterCapability).default([]),
+    outputs: z
+        .array(z.object({
+        path: z.string(),
+        kind: z.enum(['instructions', 'rule', 'command', 'agent', 'hook', 'skill', 'settings']),
+        /** Wrappers import AGENTS.md; only `delta` content may be inlined. */
+        mode: z.enum(['wrapper', 'delta', 'settings']).default('delta'),
+        /**
+         * Template filename under the adapter's `templates/`, when it is not the output's own
+         * basename plus `.tmpl`. A per-item output has no single basename — one template
+         * renders many files — and tools disagree on what to call it: GitHub Copilot's rule
+         * template is `instructions.md`, Windsurf's command template is `workflow.md`.
+         * Naming it here is data; inferring it was a guess that silently emitted nothing.
+         */
+        template: z.string().min(1).optional(),
+        when: Condition.optional(),
+    }))
+        .default([]),
+    docs: z.string().url().optional(),
+});
+/* ── registry: skills / commands / hooks / subagents ──────────────────────── */
+/**
+ * Not every registry item is delivered by an AI tool. A secret-scanning git hook works
+ * regardless of which agent is driving, and a convention stated in AGENTS.md reaches every
+ * tool at once. Modelling these as adapters would be a lie; they get their own targets.
+ */
+export const UNIVERSAL_TARGETS = ['agents-md', 'git-hooks'];
+export const UniversalTarget = z.enum(UNIVERSAL_TARGETS);
+export const RegistryItem = z.object({
+    id: Id,
+    kind: z.enum(['skill', 'command', 'hook', 'agent']),
+    name: z.string(),
+    description: z.string(),
+    tags: z.array(z.string()).default([]),
+    /** Adapter ids or universal targets. Tools skip what they cannot express. */
+    targets: z.array(Id).min(1),
+    requiresCapability: z.array(AdapterCapability).default([]),
+    when: Condition.optional(),
+    /**
+     * The item's markdown, read from the sibling file by the loader rather than authored here.
+     * Adapters render it into their tool's own shape; an item with no body would emit an empty
+     * rule file, so the loader refuses one.
+     */
+    body: z.string().default(''),
+});
+/* ── plan (the reviewable output of `groundplan plan`) ─────────────────────────── */
+export const PlannedFile = z.object({
+    path: z.string(),
+    source: z.string(),
+    action: z.enum(['create', 'overwrite', 'merge', 'skip']),
+    bytes: z.number().int().nonnegative(),
+    fromBlueprint: Id,
+});
+export const Plan = z.object({
+    solution: z.string(),
+    target: z.string(),
+    architecture: Id.optional(),
+    blueprints: z.array(Id),
+    adapters: z.array(Id),
+    variables: z.record(z.string(), z.unknown()),
+    files: z.array(PlannedFile),
+    /** `optional` steps may fail without failing generation; required ones may not. */
+    postApply: z.array(z.object({ run: ShellStep, optional: z.boolean().default(true) })),
+    warnings: z.array(z.string()).default([]),
+    /** Rendered NOTICE content when any blueprint adapts upstream code; absent otherwise. */
+    notice: z.string().optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/tokens.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Dynamic naming. One answer ("acme billing") must correctly become AcmeBilling,
+ * acme-billing, ACME_BILLING and Acme.Billing everywhere — in file contents AND
+ * in file/folder names — or the generated repo carries the previous project's identity.
+ */
+export declare const filters: {
+    readonly pascal: (v: string) => string;
+    readonly camel: (v: string) => string;
+    readonly kebab: (v: string) => string;
+    readonly snake: (v: string) => string;
+    readonly upperSnake: (v: string) => string;
+    /** .NET namespaces and Java packages: Acme.Billing */
+    readonly dot: (v: string) => string;
+    readonly title: (v: string) => string;
+    readonly lower: (v: string) => string;
+    readonly upper: (v: string) => string;
+    /** Escape for embedding inside a JSON string literal. */
+    readonly json: (v: string) => string;
+};
+export type FilterName = keyof typeof filters;
+export type Vars = Record<string, unknown>;
+export declare class UnknownTokenError extends Error {
+    readonly token: string;
+    readonly where: string;
+    constructor(token: string, where: string);
+}
+/** Substitute `{{ name | filter }}` inside file contents. */
+export declare function renderContent(source: string, vars: Vars, where?: string): string;
+/**
+ * Substitute `__name__` / `__name.filter__` in a path. Unknown names are left literal
+ * rather than rejected: `__init__.py` and `__main__.py` are ordinary Python filenames, and
+ * refusing them would make the whole language unscaffoldable. `groundplan plan` warns about what
+ * was left literal, so a typo still surfaces before anything is written.
+ */
+export declare function renderPath(source: string, vars: Vars, where?: string): string;
+/** Path tokens with no matching variable — reported, never silently dropped. */
+export declare function unresolvedPathTokens(source: string, vars: Vars): string[];
+/**
+ * Tokens in file CONTENTS. Only `{{ }}` counts here — scanning contents for `__x__` would
+ * flag every `__future__` import and `__name__` guard in a Python file.
+ */
+export declare function collectTokens(source: string): string[];

package/dist/tokens.js

@@ -0,0 +1,90 @@
+/**
+ * Dynamic naming. One answer ("acme billing") must correctly become AcmeBilling,
+ * acme-billing, ACME_BILLING and Acme.Billing everywhere — in file contents AND
+ * in file/folder names — or the generated repo carries the previous project's identity.
+ */
+/** Split on case boundaries, separators, and digit runs so every input normalizes the same way. */
+function words(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean);
+}
+export const filters = {
+    pascal: (v) => words(v).map(cap).join(''),
+    camel: (v) => {
+        const [head, ...rest] = words(v);
+        return head ? head.toLowerCase() + rest.map(cap).join('') : '';
+    },
+    kebab: (v) => words(v).map(lower).join('-'),
+    snake: (v) => words(v).map(lower).join('_'),
+    upperSnake: (v) => words(v).map(upper).join('_'),
+    /** .NET namespaces and Java packages: Acme.Billing */
+    dot: (v) => words(v).map(cap).join('.'),
+    title: (v) => words(v).map(cap).join(' '),
+    lower: (v) => words(v).map(lower).join(''),
+    upper: (v) => words(v).map(upper).join(''),
+    /** Escape for embedding inside a JSON string literal. */
+    json: (v) => JSON.stringify(v).slice(1, -1),
+};
+const cap = (w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase();
+const lower = (w) => w.toLowerCase();
+const upper = (w) => w.toUpperCase();
+/**
+ * `(?<!\$)` leaves GitHub Actions' `${{ ... }}` alone, and `\{\{` escapes a literal brace
+ * pair — CI workflows and Handlebars/Jinja templates share this syntax and must survive.
+ */
+const CONTENT_TOKEN = /(?<![$\\])\{\{\s*([a-zA-Z][a-zA-Z0-9]*)\s*(?:\|\s*([a-zA-Z]+)\s*)?\}\}/g;
+const ESCAPED_BRACES = /\\(\{\{|\}\})/g;
+const PATH_TOKEN = /__([a-zA-Z][a-zA-Z0-9]*)(?:\.([a-zA-Z]+))?__/g;
+export class UnknownTokenError extends Error {
+    token;
+    where;
+    constructor(token, where) {
+        // Fail loudly — a silently unresolved token ships the wrong name to disk.
+        super(`Unknown token "${token}" in ${where}`);
+        this.token = token;
+        this.where = where;
+    }
+}
+function apply(raw, filter, token, where) {
+    const value = raw === undefined || raw === null ? '' : String(raw);
+    if (!filter)
+        return value;
+    const fn = filters[filter];
+    if (!fn)
+        throw new UnknownTokenError(`${token}|${filter}`, where);
+    return fn(value);
+}
+/** Substitute `{{ name | filter }}` inside file contents. */
+export function renderContent(source, vars, where = 'content') {
+    return source
+        .replace(CONTENT_TOKEN, (_m, name, filter) => {
+        if (!(name in vars))
+            throw new UnknownTokenError(name, where);
+        return apply(vars[name], filter, name, where);
+    })
+        .replace(ESCAPED_BRACES, '$1');
+}
+/**
+ * Substitute `__name__` / `__name.filter__` in a path. Unknown names are left literal
+ * rather than rejected: `__init__.py` and `__main__.py` are ordinary Python filenames, and
+ * refusing them would make the whole language unscaffoldable. `groundplan plan` warns about what
+ * was left literal, so a typo still surfaces before anything is written.
+ */
+export function renderPath(source, vars, where = 'path') {
+    return source.replace(PATH_TOKEN, (match, name, filter) => name in vars ? apply(vars[name], filter, name, where) : match);
+}
+/** Path tokens with no matching variable — reported, never silently dropped. */
+export function unresolvedPathTokens(source, vars) {
+    return [...source.matchAll(PATH_TOKEN)].map((m) => m[1]).filter((name) => !(name in vars));
+}
+/**
+ * Tokens in file CONTENTS. Only `{{ }}` counts here — scanning contents for `__x__` would
+ * flag every `__future__` import and `__name__` guard in a Python file.
+ */
+export function collectTokens(source) {
+    return [...new Set([...source.matchAll(CONTENT_TOKEN)].map((m) => m[1]))];
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@opengroundplan/core",
+  "version": "0.1.1",
+  "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",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/groundplan/groundplan#readme",
+  "bugs": "https://github.com/groundplan/groundplan/issues",
+  "keywords": [
+    "scaffolding",
+    "templates",
+    "architecture",
+    "agents",
+    "agents-md",
+    "code-generation"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__",
+    "catalog",
+    "templates",
+    "adapters",
+    "registry",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "gen:python-data": "node scripts/generate-python-data.mjs",
+    "pack:release": "node scripts/pack-core.mjs",
+    "prepublishOnly": "node scripts/refuse-direct-publish.mjs"
+  },
+  "dependencies": {
+    "glob": "^11.0.0",
+    "yaml": "^2.6.1",
+    "zod": "^3.24.1"
+  }
+}