@opengroundplan/core 0.1.1 → 0.2.0

package/dist/assessment.js

@@ -0,0 +1,81 @@
+const has = (layers, prefix) => layers.some((l) => l === prefix || l.startsWith(prefix));
+/**
+ * Ten quality dimensions, each scored from the selection and the review. A high-severity finding
+ * in a dimension's area caps it low; a covered baseline scores high. Deterministic, not vibes.
+ */
+export function qualityScores(selection, findings) {
+    const layers = selection.layers;
+    const highIn = (area) => findings.some((f) => f.area === area && f.severity === 'high');
+    const anyIn = (area) => findings.some((f) => f.area === area);
+    const band = (present, area) => (highIn(area) ? 35 : anyIn(area) ? 60 : present ? 90 : 70);
+    return [
+        { dimension: 'Architecture', score: selection.architecture ? 85 : 60, note: selection.architecture ? `${selection.architecture} overlay applied` : 'no architecture overlay' },
+        { dimension: 'Security', score: band(has(layers, 'auth') && layers.includes('security-supply-chain'), 'security'), note: has(layers, 'auth') ? 'auth present' : 'no auth layer' },
+        { dimension: 'Scalability', score: band(has(layers, 'cache') || has(layers, 'queue'), 'scaling'), note: has(layers, 'cache') ? 'caching in place' : 'no caching layer' },
+        { dimension: 'Maintainability', score: Math.round(((selection.intent.priorities.maintainability ?? 3) / 5) * 100), note: 'from stated priority' },
+        { dimension: 'Performance', score: has(layers, 'cache') ? 80 : 65, note: has(layers, 'cache') ? 'cache reduces read load' : 'no cache' },
+        { dimension: 'Documentation', score: 80, note: 'blueprint docs generated; keep them current' },
+        { dimension: 'Developer experience', score: layers.includes('lint-format') ? 85 : 70, note: layers.includes('lint-format') ? 'lint/format configured' : 'add lint-format' },
+        { dimension: 'Operational readiness', score: band(has(layers, 'observability') && layers.includes('health-checks'), 'observability'), note: has(layers, 'observability') ? 'observability present' : 'no observability' },
+        { dimension: 'Testing', score: band(layers.some((l) => l.startsWith('testing')), 'testing'), note: layers.some((l) => l.startsWith('testing')) ? 'tests selected' : 'no test strategy' },
+        { dimension: 'Infrastructure', score: layers.includes('ci-github-actions') ? 85 : band(false, 'ci'), note: layers.includes('ci-github-actions') ? 'CI configured' : 'no CI pipeline' },
+    ];
+}
+/** The overall score is the mean of the dimensions. */
+export function overallScore(scores) {
+    if (scores.length === 0)
+        return 0;
+    return Math.round(scores.reduce((sum, s) => sum + s.score, 0) / scores.length);
+}
+/** One ADR per major decision — architecture and each choice-set layer (database, auth). */
+export function generateADRs(selection) {
+    const adrs = [];
+    let n = 1;
+    const top = selection.ranked.find((r) => r.architecture.id === selection.architecture) ?? selection.ranked[0];
+    if (top) {
+        adrs.push({
+            number: n++,
+            title: `Adopt ${top.architecture.name}`,
+            status: 'accepted',
+            context: `A ${selection.intent.family ?? 'general'} project on ${selection.stack}, weighed against the stated priorities.`,
+            decision: `Use ${top.architecture.name}.`,
+            alternatives: selection.ranked.filter((r) => r.architecture.id !== top.architecture.id).slice(0, 3).map((r) => `${r.architecture.name} (${Math.round(r.fit * 100)}% fit)`),
+            consequences: [top.architecture.keyTradeoff ?? 'See the architecture review for trade-offs.', ...top.concerns],
+        });
+    }
+    for (const id of selection.layers.filter((l) => l.startsWith('db-') || l.startsWith('auth'))) {
+        adrs.push({
+            number: n++,
+            title: `Use ${id}`,
+            status: 'accepted',
+            context: `The project implied this capability; ${id} is the default for the chosen stack.`,
+            decision: `Adopt ${id}.`,
+            alternatives: id.startsWith('db-') ? ['db-postgres', 'db-mongo', 'db-sqlite'].filter((x) => x !== id) : ['auth-jwt', 'auth-oidc'].filter((x) => x !== id),
+            consequences: ['Migrating away later is a schema/contract change — decide deliberately now.'],
+        });
+    }
+    return adrs;
+}
+/** The independent CTO pass — it challenges the plan using the review's high/medium findings. */
+export function ctoReview(selection, findings, scores) {
+    const blocking = findings.filter((f) => f.severity === 'high');
+    const medium = findings.filter((f) => f.severity === 'medium');
+    const overall = overallScore(scores);
+    const challenges = [...blocking, ...medium].map((f) => `${f.message} → ${f.recommendation}`);
+    if (selection.confidence < 0.4)
+        challenges.push('Inference confidence is low — validate the architecture with the team before building.');
+    for (const q of selection.questions)
+        challenges.push(`Unresolved: ${q.reason} (${q.field}).`);
+    const verdict = blocking.length ? 'needs-work' : medium.length || overall < 75 ? 'approved-with-conditions' : 'approved';
+    return {
+        verdict,
+        summary: verdict === 'needs-work'
+            ? `Not ready: ${blocking.length} blocking issue(s) would ship an unsafe or unproven system.`
+            : verdict === 'approved-with-conditions'
+                ? `Sound direction (${overall}/100), conditional on closing the items below before launch.`
+                : `Approved (${overall}/100) — a solid production baseline.`,
+        challenges,
+        conditions: [...blocking, ...medium].map((f) => f.recommendation),
+    };
+}
+//# sourceMappingURL=assessment.js.map

package/dist/assessment.js.map

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

package/dist/autoplan.d.ts

@@ -0,0 +1,60 @@
+/**
+ * From one paragraph to a complete selection — the layer that makes Groundplan an architect
+ * rather than a questionnaire. It infers intent, ranks architectures, and picks the base,
+ * layers, and tools deterministically, asking nothing it can decide with confidence.
+ *
+ * Everything is inferred from the description plus the catalog; nothing here is a hardcoded id.
+ * When a genuine fork has no basis for a choice — an unstated stack, a near-tie between
+ * architectures — it surfaces a `question` instead of guessing, so the one prompt the user
+ * sees is always one that changes the outcome.
+ */
+import { type Intent } from './intent.js';
+import { type Recommendation } from './recommend.js';
+import type { Catalog } from './loader.js';
+import type { Blueprint, Characteristic, Stack } from './schema.js';
+export interface AutoOverrides {
+    stack?: Stack;
+    architecture?: string;
+    base?: string;
+    layers?: string[];
+    adapters?: string[];
+    teamSize?: number;
+    priorities?: Partial<Record<Characteristic, number>>;
+}
+/** A fork the planner could not decide with confidence. Blocking: worth one interactive prompt. */
+export interface AutoQuestion {
+    /** 'stack' | 'priorities' | 'architecture' | 'base' | a choiceSet name (e.g. 'database'). */
+    field: string;
+    reason: string;
+    options: {
+        id: string;
+        label: string;
+        hint?: string;
+    }[];
+    /** The default applied when the question is not asked (--yes / non-interactive). */
+    chosen?: string;
+}
+export interface AutoSelection {
+    intent: Intent;
+    stack: Stack;
+    teamSize: number;
+    architecture?: string;
+    base: string;
+    layers: string[];
+    adapters: string[];
+    ranked: Recommendation[];
+    /** 0..1 — how much of this selection was decided rather than defaulted. */
+    confidence: number;
+    /** Human-readable "chose X because Y" notes for everything inferred. */
+    assumptions: string[];
+    /** Forks worth asking about; empty means the brief is enough to generate zero-question. */
+    questions: AutoQuestion[];
+}
+/** Bases for a stack that also support the architecture — the CLI reuses this when it must ask. */
+export declare function basesFor(catalog: Catalog, stack: Stack, architecture: string | undefined): Blueprint[];
+/** Layers that apply to a stack (stack-agnostic ones included). */
+export declare function layersFor(catalog: Catalog, stack: Stack): Blueprint[];
+export declare function autoSelect(description: string, catalog: Catalog, opts: {
+    defaultAdapters: string[];
+    overrides?: AutoOverrides;
+}): AutoSelection;

package/dist/autoplan.js

@@ -0,0 +1,219 @@
+/**
+ * From one paragraph to a complete selection — the layer that makes Groundplan an architect
+ * rather than a questionnaire. It infers intent, ranks architectures, and picks the base,
+ * layers, and tools deterministically, asking nothing it can decide with confidence.
+ *
+ * Everything is inferred from the description plus the catalog; nothing here is a hardcoded id.
+ * When a genuine fork has no basis for a choice — an unstated stack, a near-tie between
+ * architectures — it surfaces a `question` instead of guessing, so the one prompt the user
+ * sees is always one that changes the outcome.
+ */
+import { inferIntent } from './intent.js';
+import { recommend } from './recommend.js';
+import { resolve, ResolveError } from './resolve.js';
+/** Ranking heuristics — design constants for the inference, not deployment configuration. */
+const DEFAULT_TEAM_SIZE = 4;
+/** A runner-up within this fraction of the top score is a genuine tie worth asking about. */
+const NEAR_TIE_RATIO = 0.12;
+/** Used only when the description states no priority at all, so the ranker has something to weigh. */
+const NEUTRAL_PRIORITIES = {
+    simplicity: 4,
+    maintainability: 3,
+    testability: 2,
+};
+const FAMILY_STACK = {
+    ai: 'python',
+    data: 'python',
+    frontend: 'typescript',
+};
+const FALLBACK_STACK = 'typescript';
+/** Bases for a stack that also support the architecture — the CLI reuses this when it must ask. */
+export function basesFor(catalog, stack, architecture) {
+    return [...catalog.blueprints.values()].filter((b) => b.kind === 'base' &&
+        b.stack === stack &&
+        (!architecture ||
+            b.supportsArchitectures.length === 0 ||
+            b.supportsArchitectures.includes(architecture)));
+}
+/** Layers that apply to a stack (stack-agnostic ones included). */
+export function layersFor(catalog, stack) {
+    return [...catalog.blueprints.values()].filter((b) => b.kind === 'layer' && (!b.stack || b.stack === stack));
+}
+export function autoSelect(description, catalog, opts) {
+    const overrides = opts.overrides ?? {};
+    const text = description.toLowerCase();
+    const intent = inferIntent(description);
+    const assumptions = [];
+    const questions = [];
+    // Stack — stated wins, then the family convention (a real inference), then a blind fallback we ask about.
+    let stack = overrides.stack ?? intent.stack;
+    if (stack) {
+        assumptions.push(`Stack ${stack}${overrides.stack ? ' (you set it)' : ' inferred from the description'}`);
+    }
+    else if (intent.family && FAMILY_STACK[intent.family]) {
+        stack = FAMILY_STACK[intent.family];
+        assumptions.push(`Stack ${stack} — the default for an ${intent.family} project`);
+    }
+    else {
+        stack = FALLBACK_STACK;
+        questions.push({ field: 'stack', reason: 'no language or framework was named', options: STACK_OPTIONS, chosen: stack });
+        assumptions.push(`Assumed ${stack} — the description named no stack`);
+    }
+    const priorities = overrides.priorities ?? (hasWeight(intent.priorities) ? intent.priorities : NEUTRAL_PRIORITIES);
+    if (!overrides.priorities && !hasWeight(intent.priorities)) {
+        questions.push({
+            field: 'priorities',
+            reason: 'the description implied no clear priority',
+            options: [],
+        });
+    }
+    const teamSize = overrides.teamSize ?? intent.teamSize ?? DEFAULT_TEAM_SIZE;
+    // Architecture — rank, retry without the family filter if it excluded everything.
+    let ranked = rank(catalog.architectures.values(), { priorities, teamSize, stack, family: intent.family });
+    if (ranked.length === 0)
+        ranked = rank(catalog.architectures.values(), { priorities, teamSize, stack });
+    // Prefer the highest-ranked architecture the chosen stack can actually build — a top pick with
+    // no base on this stack is not a recommendation, it is a dead end.
+    let architecture = overrides.architecture;
+    if (!architecture && ranked.length > 0) {
+        const viable = ranked.find((r) => basesFor(catalog, stack, r.architecture.id).length > 0) ?? ranked[0];
+        architecture = viable.architecture.id;
+        assumptions.push(`Architecture ${viable.architecture.name} — ${Math.round(viable.fit * 100)}% fit`);
+        const alt = ranked.find((r) => r.architecture.id !== architecture && basesFor(catalog, stack, r.architecture.id).length > 0);
+        if (alt && viable.score > 0 && (viable.score - alt.score) / viable.score < NEAR_TIE_RATIO) {
+            questions.push({
+                field: 'architecture',
+                reason: `${alt.architecture.name} scores nearly as well`,
+                options: ranked
+                    .filter((r) => basesFor(catalog, stack, r.architecture.id).length > 0)
+                    .slice(0, 4)
+                    .map((r) => ({ id: r.architecture.id, label: r.architecture.name, hint: `${Math.round(r.fit * 100)}% fit` })),
+                chosen: architecture,
+            });
+        }
+    }
+    // Base — narrowed by stack and architecture support. If the overlay has no base on this stack,
+    // drop the overlay rather than fail: a repo with no architecture layout still builds.
+    let bases = basesFor(catalog, stack, architecture);
+    if (bases.length === 0 && architecture && !overrides.base) {
+        assumptions.push(`No ${stack} base builds "${architecture}" — generating without an architecture overlay`);
+        architecture = undefined;
+        bases = basesFor(catalog, stack, undefined);
+    }
+    // A base that names the architecture is specialized for it; a generic base (empty list) is a
+    // fallback. Prefer the specialist, and only ask when more than one is equally specialized.
+    const explicit = architecture ? bases.filter((b) => b.supportsArchitectures.includes(architecture)) : [];
+    const preferred = explicit.length > 0 ? explicit : bases;
+    const base = overrides.base ?? preferred[0]?.id;
+    if (!base)
+        throw baseError(catalog, stack, architecture);
+    if (!overrides.base && preferred.length > 1) {
+        questions.push({
+            field: 'base',
+            reason: `${preferred.length} bases fit ${stack} and ${architecture ?? 'no overlay'}`,
+            options: preferred.map((b) => ({ id: b.id, label: b.name, hint: b.description })),
+            chosen: base,
+        });
+    }
+    assumptions.push(`Base ${catalog.blueprints.get(base)?.name ?? base}`);
+    // Layers — map each implied capability to a concrete layer, defaulting inside a choice set.
+    const layers = overrides.layers ?? impliedLayers(intent.impliedLayers, catalog, stack, text, assumptions);
+    const adapters = (overrides.adapters ?? opts.defaultAdapters).filter((id) => catalog.adapters.has(id));
+    assumptions.push(`AI tools: ${adapters.join(', ') || 'none'}`);
+    // Prove the combination holds before returning it as a plan.
+    try {
+        const selected = resolve({ base, architecture, layers }, catalog.blueprints);
+        for (const w of selected.warnings)
+            assumptions.push(w);
+    }
+    catch (error) {
+        if (error instanceof ResolveError)
+            assumptions.push(`Adjust needed: ${error.message}`);
+        else
+            throw error;
+    }
+    return {
+        intent,
+        stack,
+        teamSize,
+        architecture,
+        base,
+        layers,
+        adapters,
+        ranked,
+        confidence: score(intent, ranked, questions),
+        assumptions,
+        questions,
+    };
+}
+const STACK_OPTIONS = [
+    { id: 'typescript', label: 'TypeScript / Next.js / React' },
+    { id: 'python', label: 'Python / FastAPI / AI-ML' },
+    { id: 'dotnet', label: '.NET / C#' },
+    { id: 'node', label: 'Node backend / NestJS' },
+    { id: 'go', label: 'Go' },
+    { id: 'polyglot', label: 'Polyglot / monorepo' },
+];
+function rank(candidates, req) {
+    return recommend(candidates, req);
+}
+/**
+ * Resolve an inferred capability ("db", "auth", "cache") to a concrete layer. Candidates are
+ * matched on `provides`, `tags`, and id shape so an inconsistent catalog token still resolves;
+ * a mutually-exclusive group collapses to the choiceDefault, or to whichever member the
+ * description actually named.
+ */
+function impliedLayers(implied, catalog, stack, text, assumptions) {
+    const layers = layersFor(catalog, stack);
+    const chosen = new Set();
+    for (const capability of implied) {
+        // A layer that IS the capability (by id or `provides`) beats one that merely touches it in
+        // `tags` — docker-compose tags "queue" because it can run one, but queue-broker is the layer.
+        const strong = layers.filter((l) => l.id === capability || l.id.startsWith(`${capability}-`) || l.provides.includes(capability));
+        const candidates = strong.length > 0 ? strong : layers.filter((l) => l.tags.includes(capability));
+        if (candidates.length === 0) {
+            assumptions.push(`No layer provides "${capability}" — skipped`);
+            continue;
+        }
+        const inSet = candidates.filter((c) => c.choiceSet);
+        if (inSet.length === 0) {
+            // A single concrete capability (cache, observability, evals…).
+            chosen.add(candidates[0].id);
+            continue;
+        }
+        for (const set of new Set(inSet.map((c) => c.choiceSet))) {
+            const members = inSet.filter((c) => c.choiceSet === set);
+            const named = members.find((m) => m.tags.some((t) => text.includes(t)));
+            const pick = named ?? members.find((m) => m.choiceDefault) ?? members[0];
+            chosen.add(pick.id);
+            if (named)
+                assumptions.push(`${set}: ${pick.name} — you named it`);
+            else
+                assumptions.push(`${set}: ${pick.name} (default)`);
+        }
+    }
+    return [...chosen];
+}
+function score(intent, ranked, questions) {
+    const archConfidence = ranked.length === 0 ? 0 : ranked.length === 1 ? 1 : gap(ranked[0].score, ranked[1].score);
+    const blocking = questions.filter((q) => q.field === 'stack' || q.field === 'priorities').length;
+    const raw = intent.confidence * archConfidence * Math.pow(0.6, blocking);
+    return Math.round(raw * 100) / 100;
+}
+function gap(top, next) {
+    if (top <= 0)
+        return 0;
+    return Math.min(1, 0.5 + (top - next) / top);
+}
+function hasWeight(priorities) {
+    return Object.values(priorities).some((w) => (w ?? 0) > 0);
+}
+/** The interactive base picker and the auto picker should fail with the same explanation. */
+function baseError(catalog, stack, architecture) {
+    const forStack = [...catalog.blueprints.values()].filter((b) => b.kind === 'base' && b.stack === stack);
+    return 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(', ')}.`);
+}
+//# sourceMappingURL=autoplan.js.map

package/dist/autoplan.js.map

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

package/dist/blueprint.d.ts

@@ -0,0 +1,102 @@
+/**
+ * From a selection to an engineering blueprint — the documents a team would write by hand before
+ * a line of code: understanding, requirements, architecture decisions, a roadmap, and tasks.
+ *
+ * Deterministic and catalog-driven. Everything here is derived from the `AutoSelection` (which
+ * already carries the ranked architecture, its reasons, the inferred layers, matched intent
+ * signals, confidence, and gaps) plus the catalog's own names and descriptions — no prose is
+ * invented that can't be traced to a signal or a blueprint. When a model produced the selection
+ * its reasoning rides along in `assumptions`; the blueprint reads the same either way.
+ */
+import { type AgentDescriptor, type RoleAssignment } from './agent-runtime.js';
+import { type BuildVsBuy, type CostBand, type Finding } from './analysis.js';
+import { type ADR, type CtoReview, type Score } from './assessment.js';
+import { type Simulation } from './simulate.js';
+import { type IndustryBlueprint } from './library.js';
+import type { AutoSelection } from './autoplan.js';
+import type { Catalog } from './loader.js';
+export interface Decision {
+    topic: string;
+    choice: string;
+    reason: string;
+    /** 0..1 — how firmly the selection settled this. */
+    confidence: number;
+    alternatives: string[];
+}
+export interface Requirement {
+    id: string;
+    kind: 'functional' | 'non-functional' | 'inferred';
+    text: string;
+    because?: string;
+}
+export interface Task {
+    id: string;
+    title: string;
+    phase: string;
+    dependsOn: string[];
+    fromBlueprint?: string;
+}
+/**
+ * The structured essence of a project — its DNA — derived once and carried through every
+ * document, so requirements, architecture, and roadmap all reason from the same facts.
+ */
+export interface ProjectDNA {
+    industry: string;
+    productType: string;
+    businessModel: string;
+    expectedScale: 'small' | 'growing' | 'large';
+    security: 'standard' | 'elevated';
+    compliance: 'none' | 'regulated';
+    riskLevel: 'low' | 'medium' | 'high';
+}
+export interface ProjectBlueprint {
+    idea: string;
+    domain: string;
+    dna: ProjectDNA;
+    /** The matched industry pattern from the library, when the idea maps to one. */
+    industry: IndustryBlueprint | null;
+    confidence: number;
+    understanding: string[];
+    assumptions: string[];
+    requirements: Requirement[];
+    decisions: Decision[];
+    architecture: {
+        id?: string;
+        name: string;
+        oneLine: string;
+        reasons: string[];
+        concerns: string[];
+        alternatives: {
+            name: string;
+            fit: number;
+        }[];
+    };
+    layers: {
+        id: string;
+        name: string;
+        description: string;
+    }[];
+    roadmap: {
+        phase: string;
+        goal: string;
+        items: string[];
+    }[];
+    risks: string[];
+    gaps: string[];
+    tasks: Task[];
+    /** Production-readiness findings — high severity blocks sign-off. */
+    review: Finding[];
+    buildVsBuy: BuildVsBuy[];
+    cost: CostBand[];
+    quality: Score[];
+    adrs: ADR[];
+    ctoReview: CtoReview;
+    simulation: Simulation;
+    /** Role → agent → tasks, when an agent roster is provided. */
+    orchestration: RoleAssignment[];
+    /** Task ids grouped into waves that can run in parallel (dependencies satisfied by earlier waves). */
+    executionWaves: string[][];
+}
+export declare function buildBlueprint(idea: string, selection: AutoSelection, catalog: Catalog, gaps?: string[], agents?: AgentDescriptor[]): ProjectBlueprint;
+/** The blueprint as a set of files (filename → content), ready to write into a repo. */
+export declare function renderBlueprint(bp: ProjectBlueprint): Record<string, string>;