groundwork-method 0.0.1 → 0.11.0

package/dist/src/generators/add-capability/generator.d.ts

@@ -0,0 +1,8 @@
+import { Tree } from '@nx/devkit';
+export interface AddCapabilityGeneratorSchema {
+    service: string;
+    capability: string;
+    provider?: string;
+    stack?: string;
+}
+export default function (tree: Tree, options: AddCapabilityGeneratorSchema): Promise<void>;

package/dist/src/generators/add-capability/generator.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const devkit_1 = require("@nx/devkit");
+const provenance_1 = require("../shared/provenance");
+const capabilities_1 = require("../shared/capabilities");
+/** Locate the service root in the tree. Accepts a bare name (resolved under
+ *  services/) or an explicit path. */
+function resolveServiceRoot(tree, service) {
+    const candidates = service.includes('/') ? [service] : [`services/${service}`, service];
+    for (const c of candidates) {
+        if (tree.exists(`${c}/pyproject.toml`) || tree.exists(`${c}/go.mod`) || tree.exists(`${c}/package.json`)) {
+            return c;
+        }
+    }
+    throw new Error(`Could not find service "${service}" (looked for ${candidates.join(', ')} with a pyproject.toml / go.mod / package.json).`);
+}
+/** Infer the stack from the marker file present in the service root. */
+function detectStack(tree, serviceRoot) {
+    if (tree.exists(`${serviceRoot}/pyproject.toml`))
+        return 'python';
+    if (tree.exists(`${serviceRoot}/go.mod`))
+        return 'go';
+    if (tree.exists(`${serviceRoot}/package.json`))
+        return 'typescript';
+    throw new Error(`Could not detect the stack for ${serviceRoot}.`);
+}
+async function default_1(tree, options) {
+    const capability = options.capability || 'llm';
+    const cap = (0, capabilities_1.loadCapability)(capability);
+    const provider = options.provider || cap.default;
+    const serviceRoot = resolveServiceRoot(tree, options.service);
+    const stack = options.stack || detectStack(tree, serviceRoot);
+    const result = (0, capabilities_1.applyCapability)(tree, { capability, provider, stack, serviceRoot });
+    await (0, devkit_1.formatFiles)(tree);
+    (0, provenance_1.recordGeneratorProvenance)(tree, 'add-capability', options);
+    // Guidance — the injector writes the port, adapter, contract test, deps and
+    // env, but composition-root wiring is service-specific and a compose/runner
+    // footprint is workspace-level, so we surface what the engineer must finish.
+    console.log(`\nAdded capability "${capability}" (provider: ${provider}, footprint: ${result.footprint}) to ${serviceRoot}`);
+    console.log(`  port:          ${result.files.port}`);
+    console.log(`  adapter:       ${result.files.adapter}`);
+    console.log(`  contract test: ${result.files.contractTest}`);
+    if (result.wiring)
+        console.log(`  wiring:        ${result.wiring}`);
+    if (provider === 'none') {
+        console.log(`  bet:           the contract test is strict-xfail — implement the adapter to cash it.`);
+    }
+    if (result.footprint === 'compose-service') {
+        console.log(result.materialized
+            ? `  footprint:     injected its container into docker-compose.yml — run \`./dev start\` to boot it.`
+            : `  footprint:     needs a docker-compose service, but no docker-compose.yml was found — run workspace-dev-cli first.`);
+    }
+    else if (result.footprint === 'runner') {
+        console.log(result.materialized
+            ? `  footprint:     registered as a native runner in .dev/dev.config.json — \`./dev start\` will launch it.`
+            : `  footprint:     runs as a process, but no .dev/dev.config.json was found — run workspace-dev-cli first.`);
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/src/generators/add-capability/generator.js.map

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

package/dist/src/generators/cli-app/generator.d.ts

@@ -0,0 +1,9 @@
+import { Tree } from '@nx/devkit';
+export interface CliAppGeneratorSchema {
+    name: string;
+    repl?: boolean;
+    /** Wire the CLI to the workspace core (core-access seam + `status` wiring
+     *  proof). Omit for a standalone tool that fronts no services. */
+    core?: boolean;
+}
+export default function (tree: Tree, options: CliAppGeneratorSchema): Promise<void>;

package/dist/src/generators/cli-app/generator.js

@@ -0,0 +1,140 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const devkit_1 = require("@nx/devkit");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const provenance_1 = require("../shared/provenance");
+const scaffold_helpers_1 = require("../shared/scaffold-helpers");
+const BRAND_TOKENS_PATH = '.groundwork/config/brand-tokens.json';
+/** The shared CLI render layer lives with the ./dev CLI source and is the single
+ *  source of truth. The product gets an owned copy so it can evolve independently. */
+const THEME_SRC = path.join(__dirname, '..', '..', '..', '..', 'src', 'generators', 'workspace-dev-cli', 'cli-src', 'src');
+function kebab(s) {
+    return s
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/** Project the design system's brand tokens (identity + terminal) for the product, or
+ *  a minimal Tier-1 identity derived from the name when no tokens exist. */
+function buildBrand(tree, name) {
+    if (tree.exists(BRAND_TOKENS_PATH)) {
+        try {
+            const raw = JSON.parse(tree.read(BRAND_TOKENS_PATH, 'utf-8') || '{}');
+            return { identity: raw.identity, terminal: raw.terminal };
+        }
+        catch {
+            /* malformed — fall through */
+        }
+    }
+    return {
+        identity: { appName: name, wordmark: '◢◤', primary: '#5fafff', accent: '#d7afff', voice: 'clear, modern' },
+    };
+}
+function copyShared(tree, fromRel, toRel) {
+    const content = fs.readFileSync(path.join(THEME_SRC, fromRel), 'utf-8');
+    tree.write(toRel, content);
+}
+async function default_1(tree, options) {
+    const name = options.name;
+    const binName = kebab(name) || 'cli';
+    const repl = Boolean(options.repl);
+    const core = Boolean(options.core);
+    const projectRoot = path.join('services', binName);
+    const filesDir = path.join(__dirname, '..', '..', '..', '..', 'src', 'generators', 'cli-app', 'files');
+    (0, devkit_1.generateFiles)(tree, filesDir, projectRoot, {
+        name,
+        binName,
+        repl,
+        core,
+        tmpl: '',
+    });
+    // Standalone mode: the CLI is the whole product and fronts no services, so
+    // it carries no core-access seam. Core mode (--core) keeps these files —
+    // the same seam shape electron-app (src/main/core-client.ts) and
+    // flutter-app (lib/data/services/api_client.dart) ship unconditionally;
+    // here it is opt-in because a standalone CLI genuinely has no core.
+    if (!core) {
+        tree.delete(path.join(projectRoot, 'src/core/client.ts'));
+        tree.delete(path.join(projectRoot, 'src/core/client.test.ts'));
+        tree.delete(path.join(projectRoot, 'src/commands/status.ts'));
+    }
+    // Copy the shared render layer as owned product source.
+    copyShared(tree, 'theme/tokens.ts', path.join(projectRoot, 'src/theme/tokens.ts'));
+    copyShared(tree, 'theme/color.ts', path.join(projectRoot, 'src/theme/color.ts'));
+    copyShared(tree, 'theme/render.ts', path.join(projectRoot, 'src/theme/render.ts'));
+    // Project brand tokens into the product (baked into the build via import).
+    tree.write(path.join(projectRoot, 'src/brand.json'), JSON.stringify(buildBrand(tree, name), null, 2) + '\n');
+    // Interactive layer: reuse the same prompt utilities the ./dev wizard uses.
+    if (repl) {
+        copyShared(tree, 'util/prompt.ts', path.join(projectRoot, 'src/util/prompt.ts'));
+        tree.write(path.join(projectRoot, 'src/commands/repl.ts'), `import type { Ctx } from '../registry';
+import { isInteractive, textPrompt } from '../util/prompt';
+
+/** A minimal interactive session on top of the composable spine. Extend it into a
+ *  full REPL — slash commands, streaming, autocomplete — per your design system. */
+export async function repl(ctx: Ctx): Promise<number> {
+  if (!isInteractive()) {
+    ctx.r.error('repl requires an interactive terminal.');
+    return 2;
+  }
+  ctx.r.logo('interactive session');
+  ctx.r.info("Type a name to greet, or 'exit' to quit.");
+  for (;;) {
+    const line = await textPrompt(ctx.r.painter, '>');
+    if (line === 'exit' || line === 'quit') break;
+    if (line) ctx.r.success(\`Hello, \${line}!\`);
+  }
+  return 0;
+}
+`);
+    }
+    // A CLI is invoked ad hoc, not a long-running service — register it as a
+    // runner so `./dev status` reports it and `./dev` knows how to run it, but
+    // autostart is false so it is never launched by `./dev start`.
+    (0, scaffold_helpers_1.registerRunner)(tree, {
+        name: binName,
+        kind: 'surface',
+        cmd: 'npm run dev',
+        cwd: projectRoot,
+        autostart: false,
+    });
+    await (0, devkit_1.formatFiles)(tree);
+    (0, provenance_1.recordGeneratorProvenance)(tree, 'cli-app', options);
+}
+//# sourceMappingURL=generator.js.map

package/dist/src/generators/cli-app/generator.js.map

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

package/dist/src/generators/docs-site/generator.d.ts

@@ -0,0 +1,5 @@
+import { Tree } from '@nx/devkit';
+export interface DocsSiteGeneratorSchema {
+    name: string;
+}
+export default function (tree: Tree, options: DocsSiteGeneratorSchema): Promise<() => void>;