@ashlr/hub 2.2.0

package/dist/core/lifecycle/templates.js

@@ -0,0 +1,605 @@
+/**
+ * M6: Project Lifecycle — Template Registry
+ *
+ * Four agentic-engineering starter templates for `ashlr new`.
+ * Pure data module — no filesystem or network access.
+ */
+// ---------------------------------------------------------------------------
+// Shared helpers — common files every template includes
+// ---------------------------------------------------------------------------
+function claudeMd(name, category, stack) {
+    return {
+        path: 'CLAUDE.md',
+        content: `# ${name}
+
+> Category: \`${category}\` · Stack: \`${stack}\`
+
+## About This Project
+
+This project was scaffolded with **ashlr** — a local-first agentic engineering hub.
+All AI-assisted work on this repo is wired through the **ashlr gateway** (see \`.mcp.json\`).
+
+## Agentic Engineering Conventions
+
+- **local-first via ashlr**: prefer local models; cloud fallback only when needed.
+- **genome stubs** live in \`.ashlrcode/genome/\` — update them as patterns emerge.
+- One logical change per commit; keep commits small and descriptive.
+- All new modules get a \`// M: <purpose>\` header comment.
+- Prefer explicit types over inference at module boundaries.
+
+## Quick Start
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Build
+npm run build
+\`\`\`
+
+## Session Tracking
+
+Sessions are captured automatically via \`entire\` on every commit.
+Use \`entire resume <branch>\` when picking up prior work.
+`,
+    };
+}
+function mcpJson() {
+    return {
+        path: '.mcp.json',
+        content: JSON.stringify({
+            mcpServers: {
+                ashlr: {
+                    command: 'ashlr',
+                    args: ['mcp'],
+                },
+            },
+        }, null, 2) + '\n',
+    };
+}
+function genomeGitkeep() {
+    return {
+        path: '.ashlrcode/genome/.gitkeep',
+        content: '',
+    };
+}
+function gitignore(extras = []) {
+    const lines = ['node_modules/', 'dist/', ...extras, ''];
+    return {
+        path: '.gitignore',
+        content: lines.join('\n'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Template: minimal
+// ---------------------------------------------------------------------------
+const minimalTemplate = {
+    id: 'minimal',
+    title: 'Minimal',
+    description: 'README, .gitignore, and CLAUDE.md only — a blank agentic-engineering slate.',
+    files({ name, category }) {
+        return [
+            {
+                path: 'README.md',
+                content: `# ${name}\n\n> Category: \`${category}\`\n\nA minimal project scaffolded with [ashlr](https://github.com/ashlrai/ashlr-hub).\n`,
+            },
+            {
+                path: 'package.json',
+                content: JSON.stringify({
+                    name,
+                    version: '0.1.0',
+                    description: `${name} — a minimal project scaffolded with ashlr`,
+                    type: 'module',
+                    private: true,
+                }, null, 2) + '\n',
+            },
+            gitignore(),
+            claudeMd(name, category, 'minimal'),
+            mcpJson(),
+            genomeGitkeep(),
+        ];
+    },
+};
+// ---------------------------------------------------------------------------
+// Template: node-cli
+// ---------------------------------------------------------------------------
+const nodeCliTemplate = {
+    id: 'node-cli',
+    title: 'Node CLI',
+    description: 'TypeScript ESM CLI with bin entry, tsconfig, vitest, and an ashlr-hub-lite layout.',
+    files({ name, category }) {
+        return [
+            {
+                path: 'README.md',
+                content: `# ${name}
+
+> Category: \`${category}\` · Stack: \`node-cli\`
+
+A TypeScript ESM CLI scaffolded with [ashlr](https://github.com/ashlrai/ashlr-hub).
+
+## Usage
+
+\`\`\`bash
+npm install
+npm run build
+node dist/index.js --help
+\`\`\`
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| \`npm run build\` | Compile TypeScript to \`dist/\` |
+| \`npm test\` | Run vitest suite |
+| \`npm run typecheck\` | Type-check without emitting |
+| \`npm run lint\` | ESLint |
+`,
+            },
+            {
+                path: 'package.json',
+                content: JSON.stringify({
+                    name,
+                    version: '0.1.0',
+                    description: `${name} CLI`,
+                    type: 'module',
+                    bin: {
+                        [name]: './dist/index.js',
+                    },
+                    main: './dist/index.js',
+                    scripts: {
+                        build: 'tsc',
+                        test: 'vitest run',
+                        typecheck: 'tsc --noEmit',
+                        lint: 'eslint src',
+                    },
+                    devDependencies: {
+                        typescript: '^5.4.0',
+                        vitest: '^1.6.0',
+                        '@typescript-eslint/eslint-plugin': '^7.0.0',
+                        '@typescript-eslint/parser': '^7.0.0',
+                        eslint: '^8.57.0',
+                    },
+                }, null, 2) + '\n',
+            },
+            {
+                path: 'tsconfig.json',
+                content: JSON.stringify({
+                    compilerOptions: {
+                        target: 'ES2022',
+                        module: 'NodeNext',
+                        moduleResolution: 'NodeNext',
+                        outDir: './dist',
+                        rootDir: './src',
+                        strict: true,
+                        skipLibCheck: true,
+                        declaration: true,
+                        declarationMap: true,
+                        sourceMap: true,
+                    },
+                    include: ['src'],
+                    exclude: ['node_modules', 'dist'],
+                }, null, 2) + '\n',
+            },
+            {
+                path: 'src/index.ts',
+                content: `#!/usr/bin/env node
+/**
+ * ${name} — entry point
+ */
+
+const [,, ...args] = process.argv;
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(\`${name} — a CLI tool\\n\\nUsage: ${name} [options]\\n\\nOptions:\\n  --help, -h  Show this help\`);
+  process.exit(0);
+}
+
+console.log(\`Hello from ${name}!\`);
+`,
+                mode: 0o755,
+            },
+            {
+                path: 'src/index.test.ts',
+                content: `import { describe, it, expect } from 'vitest';
+
+describe('${name}', () => {
+  it('placeholder passes', () => {
+    expect(true).toBe(true);
+  });
+});
+`,
+            },
+            gitignore(['*.tsbuildinfo']),
+            claudeMd(name, category, 'node-cli'),
+            mcpJson(),
+            genomeGitkeep(),
+        ];
+    },
+};
+// ---------------------------------------------------------------------------
+// Template: mcp-server
+// ---------------------------------------------------------------------------
+const mcpServerTemplate = {
+    id: 'mcp-server',
+    title: 'MCP Server',
+    description: 'Minimal @modelcontextprotocol/sdk stdio server skeleton with TypeScript ESM.',
+    files({ name, category }) {
+        return [
+            {
+                path: 'README.md',
+                content: `# ${name}
+
+> Category: \`${category}\` · Stack: \`mcp-server\`
+
+A minimal MCP (Model Context Protocol) stdio server scaffolded with [ashlr](https://github.com/ashlrai/ashlr-hub).
+
+## Usage
+
+\`\`\`bash
+npm install
+npm run build
+node dist/server.js
+\`\`\`
+
+Wire into a Claude Code project via \`.mcp.json\`:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "${name}": {
+      "command": "node",
+      "args": ["path/to/${name}/dist/server.js"]
+    }
+  }
+}
+\`\`\`
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| \`npm run build\` | Compile TypeScript to \`dist/\` |
+| \`npm test\` | Run vitest suite |
+| \`npm run typecheck\` | Type-check without emitting |
+`,
+            },
+            {
+                path: 'package.json',
+                content: JSON.stringify({
+                    name,
+                    version: '0.1.0',
+                    description: `${name} MCP server`,
+                    type: 'module',
+                    main: './dist/server.js',
+                    scripts: {
+                        build: 'tsc',
+                        test: 'vitest run',
+                        typecheck: 'tsc --noEmit',
+                        start: 'node dist/server.js',
+                    },
+                    dependencies: {
+                        '@modelcontextprotocol/sdk': '^1.0.0',
+                    },
+                    devDependencies: {
+                        typescript: '^5.4.0',
+                        vitest: '^1.6.0',
+                    },
+                }, null, 2) + '\n',
+            },
+            {
+                path: 'tsconfig.json',
+                content: JSON.stringify({
+                    compilerOptions: {
+                        target: 'ES2022',
+                        module: 'NodeNext',
+                        moduleResolution: 'NodeNext',
+                        outDir: './dist',
+                        rootDir: './src',
+                        strict: true,
+                        skipLibCheck: true,
+                        declaration: true,
+                        sourceMap: true,
+                    },
+                    include: ['src'],
+                    exclude: ['node_modules', 'dist'],
+                }, null, 2) + '\n',
+            },
+            {
+                path: 'src/server.ts',
+                content: `/**
+ * ${name} — MCP stdio server entry point
+ *
+ * Skeleton using @modelcontextprotocol/sdk.
+ * Add your tools, resources, and prompts below.
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+const server = new Server(
+  { name: '${name}', version: '0.1.0' },
+  { capabilities: { tools: {} } },
+);
+
+// ---------------------------------------------------------------------------
+// Tools
+// ---------------------------------------------------------------------------
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: 'hello',
+      description: 'A starter tool — returns a greeting.',
+      inputSchema: {
+        type: 'object' as const,
+        properties: {
+          name: { type: 'string', description: 'Name to greet' },
+        },
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name: toolName, arguments: args } = request.params;
+
+  if (toolName === 'hello') {
+    const who = (args as { name?: string }).name ?? 'world';
+    return {
+      content: [{ type: 'text', text: \`Hello, \${who}! From ${name} MCP server.\` }],
+    };
+  }
+
+  throw new Error(\`Unknown tool: \${toolName}\`);
+});
+
+// ---------------------------------------------------------------------------
+// Start
+// ---------------------------------------------------------------------------
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+`,
+                mode: 0o755,
+            },
+            {
+                path: 'src/server.test.ts',
+                content: `import { describe, it, expect } from 'vitest';
+
+describe('${name} server', () => {
+  it('placeholder passes', () => {
+    expect(true).toBe(true);
+  });
+});
+`,
+            },
+            gitignore(['*.tsbuildinfo']),
+            claudeMd(name, category, 'mcp-server'),
+            mcpJson(),
+            genomeGitkeep(),
+        ];
+    },
+};
+// ---------------------------------------------------------------------------
+// Template: next-app
+// ---------------------------------------------------------------------------
+const nextAppTemplate = {
+    id: 'next-app',
+    title: 'Next.js App',
+    description: 'Minimal Next.js 14 App Router project with TypeScript and Tailwind CSS.',
+    files({ name, category }) {
+        return [
+            {
+                path: 'README.md',
+                content: `# ${name}
+
+> Category: \`${category}\` · Stack: \`next-app\`
+
+A minimal Next.js 14 application scaffolded with [ashlr](https://github.com/ashlrai/ashlr-hub).
+
+## Usage
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+Open [http://localhost:3000](http://localhost:3000).
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| \`npm run dev\` | Start development server |
+| \`npm run build\` | Production build |
+| \`npm start\` | Start production server |
+| \`npm run lint\` | ESLint |
+`,
+            },
+            {
+                path: 'package.json',
+                content: JSON.stringify({
+                    name,
+                    version: '0.1.0',
+                    description: `${name} Next.js app`,
+                    private: true,
+                    scripts: {
+                        dev: 'next dev',
+                        build: 'next build',
+                        start: 'next start',
+                        lint: 'next lint',
+                    },
+                    dependencies: {
+                        next: '^14.2.0',
+                        react: '^18.3.0',
+                        'react-dom': '^18.3.0',
+                    },
+                    devDependencies: {
+                        typescript: '^5.4.0',
+                        '@types/node': '^20.0.0',
+                        '@types/react': '^18.3.0',
+                        '@types/react-dom': '^18.3.0',
+                        tailwindcss: '^3.4.0',
+                        autoprefixer: '^10.4.0',
+                        postcss: '^8.4.0',
+                        eslint: '^8.57.0',
+                        'eslint-config-next': '^14.2.0',
+                    },
+                }, null, 2) + '\n',
+            },
+            {
+                path: 'tsconfig.json',
+                content: JSON.stringify({
+                    compilerOptions: {
+                        target: 'ES2017',
+                        lib: ['dom', 'dom.iterable', 'esnext'],
+                        allowJs: true,
+                        skipLibCheck: true,
+                        strict: true,
+                        noEmit: true,
+                        esModuleInterop: true,
+                        module: 'esnext',
+                        moduleResolution: 'bundler',
+                        resolveJsonModule: true,
+                        isolatedModules: true,
+                        jsx: 'preserve',
+                        incremental: true,
+                        plugins: [{ name: 'next' }],
+                        paths: { '@/*': ['./src/*'] },
+                    },
+                    include: ['next-env.d.ts', '**/*.ts', '**/*.tsx', '.next/types/**/*.ts'],
+                    exclude: ['node_modules'],
+                }, null, 2) + '\n',
+            },
+            {
+                path: 'next.config.ts',
+                content: `import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  // Add your Next.js config here
+};
+
+export default nextConfig;
+`,
+            },
+            {
+                path: 'src/app/layout.tsx',
+                content: `import type { Metadata } from 'next';
+
+export const metadata: Metadata = {
+  title: '${name}',
+  description: '${name} — scaffolded with ashlr',
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}
+`,
+            },
+            {
+                path: 'src/app/page.tsx',
+                content: `export default function Home() {
+  return (
+    <main>
+      <h1>${name}</h1>
+      <p>Scaffolded with <strong>ashlr</strong>. Start editing <code>src/app/page.tsx</code>.</p>
+    </main>
+  );
+}
+`,
+            },
+            {
+                path: 'src/app/globals.css',
+                content: `@tailwind base;
+@tailwind components;
+@tailwind utilities;
+`,
+            },
+            {
+                path: 'tailwind.config.ts',
+                content: `import type { Config } from 'tailwindcss';
+
+const config: Config = {
+  content: [
+    './src/pages/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/components/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/app/**/*.{js,ts,jsx,tsx,mdx}',
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};
+
+export default config;
+`,
+            },
+            {
+                path: 'postcss.config.js',
+                content: `export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};
+`,
+            },
+            {
+                path: '.eslintrc.json',
+                content: JSON.stringify({ extends: 'next/core-web-vitals' }, null, 2) + '\n',
+            },
+            gitignore(['.next/', 'out/', '*.tsbuildinfo', '.env*.local']),
+            claudeMd(name, category, 'next-app'),
+            mcpJson(),
+            genomeGitkeep(),
+        ];
+    },
+};
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+export const TEMPLATES = [
+    nodeCliTemplate,
+    mcpServerTemplate,
+    nextAppTemplate,
+    minimalTemplate,
+];
+/**
+ * M33: builtin TEMPLATES + validated templates from enabled plugins.
+ * Best-effort: a broken plugin layer yields the builtins only. Plugin
+ * template ids arrive prefixed `<plugin>:<id>` (wrappers.validateTemplate).
+ */
+export async function getTemplates(cfg) {
+    let fromPlugins = [];
+    try {
+        const { loadConfig } = await import('../config.js');
+        const { getPluginTemplates } = await import('../plugins/registry.js');
+        fromPlugins = await getPluginTemplates(cfg ?? loadConfig());
+    }
+    catch {
+        fromPlugins = [];
+    }
+    return [...TEMPLATES, ...fromPlugins];
+}
+export function getTemplate(id) {
+    return TEMPLATES.find((t) => t.id === id) ?? null;
+}
+export function listTemplates() {
+    return TEMPLATES.map(({ id, title, description }) => ({ id, title, description }));
+}
+//# sourceMappingURL=templates.js.map

package/dist/core/lifecycle/templates.js.map

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

package/dist/core/mcp-gateway.d.ts

@@ -0,0 +1,59 @@
+/**
+ * core/mcp-gateway.ts — MCP aggregation gateway + per-server probe.
+ *
+ * Two responsibilities:
+ *
+ *   1. probeServer(spec, timeoutMs): start ONE downstream MCP server as a child,
+ *      list its tools, tear it down, and return an McpServerHealth. NEVER throws —
+ *      startup failures, timeouts, and crashes surface in the returned health
+ *      object (ok:false + error). Used by `ashlr mcp doctor` and gateway startup.
+ *
+ *   2. startGateway(registry): run a stdio MCP server (this process) that starts
+ *      every discovered downstream as a child, namespaces their tools as
+ *      `<server>__<tool>`, and proxies tools/list + tools/call to the correct
+ *      downstream. ROBUST: per-downstream startup timeout; a downstream that
+ *      fails to start is skipped with a stderr warning and never crashes the
+ *      gateway. Point ANY agent at `ashlr mcp` to get every discovered tool.
+ *
+ * This module is the ONLY place (besides mcp-registry) allowed to depend on
+ * @modelcontextprotocol/sdk.
+ */
+import type { McpRegistry, McpServerSpec, McpServerHealth } from './types.js';
+/**
+ * Env var set on every downstream child the gateway spawns. A downstream that
+ * is itself an ashlr gateway can read this to refuse re-aggregation, providing
+ * a second line of defense against the self-spawn fork bomb (the primary
+ * defense is isSelfGateway() filtering at startGateway).
+ */
+export declare const GATEWAY_ENV_MARKER = "ASHLR_MCP_GATEWAY";
+/**
+ * True when a spec resolves to THIS aggregation gateway — i.e. running it as a
+ * downstream would recurse (`ashlr mcp install` writes exactly such an entry:
+ * name "ashlr", command <bin>/ashlr, args ['mcp']). We detect it structurally
+ * (no path resolution needed): the canonical installed entry is `args`
+ * containing 'mcp' AND the command basename being `ashlr`, OR the conventional
+ * name 'ashlr' paired with an 'mcp' arg. Skipping these prevents an unbounded
+ * fan-out of nested gateways.
+ */
+export declare function isSelfGateway(spec: McpServerSpec): boolean;
+/**
+ * Start a single downstream MCP server, list its tools, and tear it down.
+ * NEVER throws — all failures (ENOENT, crash, timeout) are reported via the
+ * returned McpServerHealth (ok:false, toolCount:0, tools:[], error:<msg>).
+ *
+ * @param spec       The downstream server spec to probe.
+ * @param timeoutMs  Per-probe startup/list timeout (default 8s).
+ */
+export declare function probeServer(spec: McpServerSpec, timeoutMs?: number): Promise<McpServerHealth>;
+/**
+ * Run the aggregation gateway on stdio.
+ *
+ * Starts every server in `registry` as a child (skipping any that fail to start
+ * within the timeout, with a stderr warning), exposes their tools namespaced as
+ * `<server>__<tool>`, and proxies tools/list + tools/call to the owning
+ * downstream. Resolves only when the gateway transport closes (stdin EOF).
+ *
+ * @param registry   The discovered MCP servers to aggregate.
+ * @param timeoutMs  Per-downstream startup timeout (default 8s).
+ */
+export declare function startGateway(registry: McpRegistry, timeoutMs?: number): Promise<void>;