@ai-sdlc/orchestrator 0.2.0 → 0.4.0

package/dist/adapters.d.ts

@@ -55,6 +55,6 @@ export declare function scanPipelineAdapters(options: ScanOptions): Promise<Scan
  * Requires `GITHUB_REPOSITORY_OWNER` and `GITHUB_REPOSITORY` env vars.
  */
 export declare function createPipelineCIAdapter(): CIPipeline;
-export { createGitHubCIPipeline, createDockerSandbox, createLinearIssueTracker, resolveSecret, createGitLabSourceControl, createGitLabCIPipeline, createJiraIssueTracker, createWebhookServer, createGitHubWebhookProvider, verifyGitHubSignature, createGitLabWebhookProvider, verifyGitLabToken, createJiraWebhookProvider, createLinearWebhookProvider, verifyLinearSignature, createAdapterRegistry, validateAdapterMetadata, parseMetadataYaml, scanLocalAdapters, createStubCodeAnalysis, createStubMessenger, createStubDeploymentTarget, createStubGitLabCI, createStubGitLabSource, createStubJira, createStubBitbucket, createStubSonarQube, createStubSemgrep, createInMemoryAuditSink, createFileSink, createEnvSecretStore, createInMemoryMemoryStore, createInProcessEventBus, createStubSandbox, createWebhookBridge, parseGitAdapterRef, buildRawUrl, createGitAdapterFetcher, createStubGitAdapterFetcher, resolveGitAdapter, } from '@ai-sdlc/reference';
-export type { AdapterRegistry, AdapterMetadata, AdapterStability, AdapterFactory, MetadataValidationResult, ScanOptions, ScanResult, WebhookBridge, WebhookTransformer, GitAdapterReference, GitAdapterFetcher, GitResolveResult, CIPipeline, CodeAnalysis, Messenger, DeploymentTarget, EventBus, IssueTracker, LinearClientLike, IssueComment, AdapterInterfaces, EventStream, IssueFilter, CommitStatus, TestResults, CoverageReport, Finding, SeveritySummary, DeploymentStatus, StubCodeAnalysisConfig, StubCodeAnalysisAdapter, NotificationLogEntry, StubMessengerAdapter, StubDeploymentTargetAdapter, StubGitLabCIAdapter, StubGitLabSourceAdapter, StubJiraAdapter, StubBitbucketAdapter, StubSonarQubeConfig, StubSonarQubeAdapter, StubSemgrepConfig, StubSemgrepAdapter, AuditSink, AuditLog, InMemoryAuditSink, SecretStore, Sandbox, MemoryStore, InMemoryMemoryStore, InProcessEventBus, DockerSandboxConfig, BuildStatus, GitLabConfig, JiraConfig, WebhookServer, WebhookServerConfig, WebhookProviderConfig, GitHubWebhookConfig, GitHubWebhookBridges, GitLabWebhookConfig, JiraWebhookConfig, LinearWebhookConfig, } from '@ai-sdlc/reference';
+export { createGitHubCIPipeline, createDockerSandbox, createLinearIssueTracker, resolveSecret, createGitLabSourceControl, createGitLabCIPipeline, createJiraIssueTracker, createBacklogMdIssueTracker, createWebhookServer, createGitHubWebhookProvider, verifyGitHubSignature, createGitLabWebhookProvider, verifyGitLabToken, createJiraWebhookProvider, createLinearWebhookProvider, verifyLinearSignature, createAdapterRegistry, validateAdapterMetadata, parseMetadataYaml, scanLocalAdapters, createStubCodeAnalysis, createStubMessenger, createStubDeploymentTarget, createStubGitLabCI, createStubGitLabSource, createStubJira, createStubBitbucket, createStubSonarQube, createStubSemgrep, createInMemoryAuditSink, createFileSink, createEnvSecretStore, createInMemoryMemoryStore, createInProcessEventBus, createStubSandbox, createWebhookBridge, parseGitAdapterRef, buildRawUrl, createGitAdapterFetcher, createStubGitAdapterFetcher, resolveGitAdapter, } from '@ai-sdlc/reference';
+export type { AdapterRegistry, AdapterMetadata, AdapterStability, AdapterFactory, MetadataValidationResult, ScanOptions, ScanResult, WebhookBridge, WebhookTransformer, GitAdapterReference, GitAdapterFetcher, GitResolveResult, CIPipeline, CodeAnalysis, Messenger, DeploymentTarget, EventBus, IssueTracker, LinearClientLike, IssueComment, AdapterInterfaces, EventStream, IssueFilter, CommitStatus, TestResults, CoverageReport, Finding, SeveritySummary, DeploymentStatus, StubCodeAnalysisConfig, StubCodeAnalysisAdapter, NotificationLogEntry, StubMessengerAdapter, StubDeploymentTargetAdapter, StubGitLabCIAdapter, StubGitLabSourceAdapter, StubJiraAdapter, StubBitbucketAdapter, StubSonarQubeConfig, StubSonarQubeAdapter, StubSemgrepConfig, StubSemgrepAdapter, AuditSink, AuditLog, InMemoryAuditSink, SecretStore, Sandbox, MemoryStore, InMemoryMemoryStore, InProcessEventBus, DockerSandboxConfig, BuildStatus, GitLabConfig, JiraConfig, BacklogMdConfig, BacklogFs, WebhookServer, WebhookServerConfig, WebhookProviderConfig, GitHubWebhookConfig, GitHubWebhookBridges, GitLabWebhookConfig, JiraWebhookConfig, LinearWebhookConfig, } from '@ai-sdlc/reference';
 //# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.js

@@ -14,6 +14,8 @@ createStubCodeAnalysis, createStubMessenger, createStubDeploymentTarget, createS
 createInMemoryAuditSink, createFileSink, createAuditLog, createEnvSecretStore, createInMemoryMemoryStore, createInProcessEventBus, createStubSandbox, 
 // Docker sandbox
 createDockerSandbox, 
+// Backlog.md adapter
+createBacklogMdIssueTracker, 
 // Webhook bridge (used in function body)
 createWebhookBridge, 
 // Git resolver (used in function bodies)
@@ -45,6 +47,7 @@ export function createPipelineAdapterRegistry() {
     registry.register(stubMeta('bitbucket-stub', 'Bitbucket', 'SourceControl', 'bitbucket'), () => createStubBitbucket());
     registry.register(stubMeta('sonarqube-stub', 'SonarQube', 'CodeAnalysis', 'sonarqube'), () => createStubSonarQube());
     registry.register(stubMeta('semgrep-stub', 'Semgrep', 'CodeAnalysis', 'semgrep'), () => createStubSemgrep());
+    registry.register(stubMeta('backlog-md', 'Backlog.md', 'IssueTracker', 'backlog-md'), () => createBacklogMdIssueTracker({ backlogDir: process.env.AI_SDLC_BACKLOG_DIR ?? './backlog' }));
     // Infrastructure adapter stubs
     registry.register(stubMeta('memory-audit-sink', 'In-Memory Audit Sink', 'AuditSink@v1', 'memory'), () => createInMemoryAuditSink());
     // file-audit-sink is registered metadata-only; the actual file path is
@@ -143,6 +146,8 @@ export {
 createGitHubCIPipeline, createDockerSandbox, createLinearIssueTracker, resolveSecret, 
 // Production adapters
 createGitLabSourceControl, createGitLabCIPipeline, createJiraIssueTracker, 
+// Backlog.md adapter
+createBacklogMdIssueTracker, 
 // Webhook server
 createWebhookServer, 
 // Webhook providers

package/dist/cli/commands/init.js

@@ -2,8 +2,10 @@
  * ai-sdlc init — initialize a project with AI-SDLC config files.
  */
 import { Command } from 'commander';
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, appendFileSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { detectAgents, installMcpServer } from './mcp-setup.js';
+import { detectWorkspace, generateWorkspaceYaml } from './workspace-detect.js';
 const PIPELINE_YAML = `apiVersion: ai-sdlc.io/v1alpha1
 kind: Pipeline
 metadata:
@@ -132,23 +134,42 @@ spec:
       action: demote-one-level
       cooldown: 2w
 `;
-export const initCommand = new Command('init')
-    .description('Initialize AI-SDLC configuration in the current project')
-    .option('--dry-run', 'Show what would be created without writing files')
-    .option('-d, --dir <path>', 'Config directory name', '.ai-sdlc')
-    .action(async (opts) => {
-    const configDir = join(process.cwd(), opts.dir ?? '.ai-sdlc');
+const GITIGNORE_ENTRIES = [
+    '# AI-SDLC runtime artifacts',
+    '.ai-sdlc/state.db',
+    '.ai-sdlc/state/',
+    '.ai-sdlc/audit.jsonl',
+];
+/** Ensure .gitignore includes AI-SDLC runtime artifact entries. */
+function ensureGitignore(projectDir, dryRun, prefix = '') {
+    const gitignorePath = join(projectDir, '.gitignore');
+    const existing = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf-8') : '';
+    const missing = GITIGNORE_ENTRIES.filter((entry) => !existing.includes(entry));
+    if (missing.length === 0)
+        return;
+    if (dryRun) {
+        console.log(`${prefix}  Would update .gitignore`);
+        return;
+    }
+    const block = '\n' + missing.join('\n') + '\n';
+    appendFileSync(gitignorePath, block, 'utf-8');
+    console.log(`${prefix}  updated .gitignore`);
+}
+/** Initialize a single project directory with AI-SDLC config files. */
+function initProject(projectDir, configDirName, dryRun, prefix = '') {
+    const configDir = join(projectDir, configDirName);
     const files = [
         { name: 'pipeline.yaml', content: PIPELINE_YAML },
         { name: 'agent-role.yaml', content: AGENT_ROLE_YAML },
         { name: 'quality-gate.yaml', content: QUALITY_GATE_YAML },
         { name: 'autonomy-policy.yaml', content: AUTONOMY_POLICY_YAML },
     ];
-    if (opts.dryRun) {
-        console.log(`Would create ${configDir}/`);
+    if (dryRun) {
+        console.log(`${prefix}Would create ${configDir}/`);
         for (const f of files) {
-            console.log(`  ${f.name}`);
+            console.log(`${prefix}  ${f.name}`);
         }
+        ensureGitignore(projectDir, true, prefix);
         return;
     }
     if (!existsSync(configDir)) {
@@ -157,20 +178,90 @@ export const initCommand = new Command('init')
     for (const f of files) {
         const path = join(configDir, f.name);
         if (existsSync(path)) {
-            console.log(`  skip ${f.name} (already exists)`);
+            console.log(`${prefix}  skip ${f.name} (already exists)`);
         }
         else {
             writeFileSync(path, f.content, 'utf-8');
-            console.log(`  created ${f.name}`);
+            console.log(`${prefix}  created ${f.name}`);
         }
     }
-    // Create state directory for SQLite store
-    const stateDir = join(configDir, 'state');
-    if (!existsSync(stateDir)) {
-        mkdirSync(stateDir, { recursive: true });
-        console.log(`  created state/`);
+    ensureGitignore(projectDir, false, prefix);
+}
+/** Initialize the workspace root with workspace.yaml. */
+function initWorkspaceRoot(workspacePath, repos, configDirName, dryRun) {
+    const configDir = join(workspacePath, configDirName);
+    const workspaceFile = join(configDir, 'workspace.yaml');
+    const workspaceName = basename(workspacePath);
+    const yaml = generateWorkspaceYaml(workspaceName, repos);
+    if (dryRun) {
+        console.log(`Would create ${configDir}/`);
+        console.log(`  workspace.yaml`);
+        return;
+    }
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+    }
+    if (existsSync(workspaceFile)) {
+        console.log(`  skip workspace.yaml (already exists)`);
+    }
+    else {
+        writeFileSync(workspaceFile, yaml, 'utf-8');
+        console.log(`  created workspace.yaml`);
+    }
+}
+export const initCommand = new Command('init')
+    .description('Initialize AI-SDLC configuration in the current project')
+    .option('--dry-run', 'Show what would be created without writing files')
+    .option('--skip-mcp', 'Skip MCP server auto-configuration')
+    .option('-d, --dir <path>', 'Config directory name', '.ai-sdlc')
+    .action(async (opts) => {
+    const projectDir = process.cwd();
+    const configDirName = opts.dir ?? '.ai-sdlc';
+    const dryRun = !!opts.dryRun;
+    // Detect workspace (multi-repo parent directory)
+    const workspace = detectWorkspace(projectDir);
+    if (workspace.isWorkspace) {
+        console.log(`Workspace detected with ${workspace.repos.length} repositories:`);
+        for (const repo of workspace.repos) {
+            console.log(`  ${repo.name} (${repo.path})`);
+        }
+        console.log('');
+        // Initialize workspace root with workspace.yaml
+        initWorkspaceRoot(projectDir, workspace.repos, configDirName, dryRun);
+        // Cascade into each child repo
+        for (const repo of workspace.repos) {
+            console.log(`\n${repo.name}/`);
+            initProject(repo.absPath, configDirName, dryRun, '  ');
+        }
+        // MCP setup at workspace root (serves all repos)
+        if (!opts.skipMcp) {
+            const agents = detectAgents(projectDir, { isWorkspace: true });
+            console.log(`\nMCP server setup (workspace root):`);
+            console.log(`  detected ${agents.map((a) => a.name).join(', ')}`);
+            for (const agent of agents) {
+                const status = installMcpServer(projectDir, agent, dryRun);
+                const pad = status === 'merged' ? ' ' : '';
+                console.log(`  ${status}${pad} ${agent.configPath} (${agent.name})`);
+            }
+        }
+        console.log(`\nAI-SDLC workspace initialized in ${projectDir}/`);
+        console.log(`Run 'ai-sdlc health' to verify your configuration.`);
+    }
+    else {
+        // Single-repo mode (original behavior)
+        initProject(projectDir, configDirName, dryRun);
+        if (!opts.skipMcp) {
+            const agents = detectAgents(projectDir);
+            console.log(`\nMCP server setup:`);
+            console.log(`  detected ${agents.map((a) => a.name).join(', ')}`);
+            for (const agent of agents) {
+                const status = installMcpServer(projectDir, agent, dryRun);
+                const pad = status === 'merged' ? ' ' : '';
+                console.log(`  ${status}${pad} ${agent.configPath} (${agent.name})`);
+            }
+        }
+        console.log(`\nAI-SDLC config initialized in ${join(projectDir, configDirName)}/`);
+        console.log(`Run 'ai-sdlc health' to verify your configuration.`);
     }
-    console.log(`\nAI-SDLC config initialized in ${configDir}/`);
-    console.log(`Run 'ai-sdlc health' to verify your configuration.`);
 });
 //# sourceMappingURL=init.js.map

package/dist/cli/commands/mcp-setup.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP server setup — detect coding agents and install MCP config.
+ */
+export interface DetectedAgent {
+    name: string;
+    configPath: string;
+    configKey: string;
+    serverEntry: Record<string, unknown>;
+}
+export interface DetectAgentsOptions {
+    /** When true, adds AI_SDLC_WORKSPACE env to server entries. */
+    isWorkspace?: boolean;
+}
+export declare function detectAgents(projectDir: string, options?: DetectAgentsOptions): DetectedAgent[];
+export declare function installMcpServer(projectDir: string, agent: DetectedAgent, dryRun: boolean): 'created' | 'merged' | 'skipped';
+//# sourceMappingURL=mcp-setup.d.ts.map

package/dist/cli/commands/mcp-setup.js

@@ -0,0 +1,131 @@
+/**
+ * MCP server setup — detect coding agents and install MCP config.
+ */
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
+function standardEntry(env) {
+    const entry = {
+        command: 'npx',
+        args: ['-y', '@ai-sdlc/mcp-advisor'],
+    };
+    if (env)
+        entry.env = env;
+    return entry;
+}
+function vscodeEntry(env) {
+    const entry = {
+        type: 'stdio',
+        command: 'npx',
+        args: ['-y', '@ai-sdlc/mcp-advisor'],
+    };
+    if (env)
+        entry.env = env;
+    return entry;
+}
+const AGENT_SPECS = [
+    {
+        name: 'Claude Code',
+        configPath: '.mcp.json',
+        configKey: 'mcpServers',
+        entryFn: standardEntry,
+        binary: 'claude',
+        alwaysDetect: true,
+    },
+    {
+        name: 'Cursor',
+        configPath: '.cursor/mcp.json',
+        configKey: 'mcpServers',
+        entryFn: standardEntry,
+        configDir: '.cursor',
+        binary: 'cursor',
+    },
+    {
+        name: 'VS Code',
+        configPath: '.vscode/mcp.json',
+        configKey: 'servers',
+        entryFn: vscodeEntry,
+        configDir: '.vscode',
+        binary: 'code',
+    },
+    {
+        name: 'Windsurf',
+        configPath: '.windsurf/mcp.json',
+        configKey: 'mcpServers',
+        entryFn: standardEntry,
+        configDir: '.windsurf',
+        binary: 'windsurf',
+    },
+];
+function hasBinary(name) {
+    try {
+        execSync(`which ${name}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function detectAgents(projectDir, options) {
+    const detected = [];
+    const env = options?.isWorkspace ? { AI_SDLC_WORKSPACE: '.' } : undefined;
+    for (const spec of AGENT_SPECS) {
+        if (spec.alwaysDetect) {
+            detected.push({
+                name: spec.name,
+                configPath: spec.configPath,
+                configKey: spec.configKey,
+                serverEntry: spec.entryFn(env),
+            });
+            continue;
+        }
+        const hasDir = spec.configDir ? existsSync(join(projectDir, spec.configDir)) : false;
+        const hasBin = spec.binary ? hasBinary(spec.binary) : false;
+        if (hasDir || hasBin) {
+            detected.push({
+                name: spec.name,
+                configPath: spec.configPath,
+                configKey: spec.configKey,
+                serverEntry: spec.entryFn(env),
+            });
+        }
+    }
+    return detected;
+}
+export function installMcpServer(projectDir, agent, dryRun) {
+    const fullPath = join(projectDir, agent.configPath);
+    if (existsSync(fullPath)) {
+        let existing;
+        try {
+            existing = JSON.parse(readFileSync(fullPath, 'utf-8'));
+        }
+        catch {
+            // If the file is malformed JSON, treat as new
+            existing = {};
+        }
+        const section = (existing[agent.configKey] ?? {});
+        if (section['ai-sdlc']) {
+            return 'skipped';
+        }
+        if (!dryRun) {
+            section['ai-sdlc'] = agent.serverEntry;
+            existing[agent.configKey] = section;
+            writeFileSync(fullPath, JSON.stringify(existing, null, 2) + '\n', 'utf-8');
+        }
+        return 'merged';
+    }
+    if (!dryRun) {
+        const dir = dirname(fullPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        const config = {
+            [agent.configKey]: {
+                'ai-sdlc': agent.serverEntry,
+            },
+        };
+        writeFileSync(fullPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    }
+    return 'created';
+}
+//# sourceMappingURL=mcp-setup.js.map

package/dist/cli/commands/workspace-detect.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Workspace detection — identify multi-repo workspaces and child repositories.
+ */
+export interface WorkspaceRepo {
+    name: string;
+    path: string;
+    absPath: string;
+}
+export interface WorkspaceInfo {
+    isWorkspace: boolean;
+    workspacePath: string;
+    repos: WorkspaceRepo[];
+}
+/**
+ * Detect if a directory is a multi-repo workspace root.
+ * A workspace root is a directory that:
+ *   1. Is NOT itself a git repository
+ *   2. Contains at least 2 child directories that ARE git repositories
+ */
+export declare function detectWorkspace(dir: string): WorkspaceInfo;
+export declare function generateWorkspaceYaml(workspaceName: string, repos: WorkspaceRepo[]): string;
+//# sourceMappingURL=workspace-detect.d.ts.map

package/dist/cli/commands/workspace-detect.js

@@ -0,0 +1,65 @@
+/**
+ * Workspace detection — identify multi-repo workspaces and child repositories.
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+/**
+ * Detect if a directory is a multi-repo workspace root.
+ * A workspace root is a directory that:
+ *   1. Is NOT itself a git repository
+ *   2. Contains at least 2 child directories that ARE git repositories
+ */
+export function detectWorkspace(dir) {
+    const absDir = resolve(dir);
+    const isGitRepo = existsSync(join(absDir, '.git'));
+    if (isGitRepo) {
+        return { isWorkspace: false, workspacePath: absDir, repos: [] };
+    }
+    const repos = [];
+    let entries;
+    try {
+        entries = readdirSync(absDir);
+    }
+    catch {
+        return { isWorkspace: false, workspacePath: absDir, repos: [] };
+    }
+    for (const entry of entries) {
+        if (entry.startsWith('.'))
+            continue;
+        const childPath = join(absDir, entry);
+        try {
+            if (!statSync(childPath).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        if (existsSync(join(childPath, '.git'))) {
+            repos.push({
+                name: entry,
+                path: `./${entry}`,
+                absPath: childPath,
+            });
+        }
+    }
+    return {
+        isWorkspace: repos.length >= 2,
+        workspacePath: absDir,
+        repos,
+    };
+}
+const WORKSPACE_YAML_TEMPLATE = (name, repos) => {
+    const repoEntries = repos.map((r) => `    - name: ${r.name}\n      path: ${r.path}`).join('\n');
+    return `apiVersion: ai-sdlc.io/v1alpha1
+kind: Workspace
+metadata:
+  name: ${name}
+spec:
+  repos:
+${repoEntries}
+`;
+};
+export function generateWorkspaceYaml(workspaceName, repos) {
+    return WORKSPACE_YAML_TEMPLATE(workspaceName, repos);
+}
+//# sourceMappingURL=workspace-detect.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdlc/orchestrator",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "AI-SDLC Orchestrator — long-running runtime that drives issues through the complete SDLC with AI agents",
   "license": "Apache-2.0",
   "repository": {
@@ -45,7 +45,7 @@
     "better-sqlite3": "^11.0.0",
     "commander": "^12.0.0",
     "yaml": "^2.7.0",
-    "@ai-sdlc/reference": "0.2.0"
+    "@ai-sdlc/reference": "0.4.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",