@ai-sdlc/orchestrator 0.3.0 → 0.5.0

package/dist/adapters.d.ts

@@ -3,7 +3,8 @@
  * webhook bridge, git-based adapter resolver, and adapter registry/scanner
  * into the dogfood pipeline.
  */
-import { type AdapterRegistry, type ScanOptions, type ScanResult, type WebhookBridge, type GitAdapterFetcher, type GitResolveResult, type AuditLog, type AuditSink, type Sandbox, type SecretStore, type MemoryStore, type EventBus, type CIPipeline } from '@ai-sdlc/reference';
+import type { AiSdlcConfig } from './config.js';
+import { type IssueTracker, type AdapterRegistry, type ScanOptions, type ScanResult, type WebhookBridge, type GitAdapterFetcher, type GitResolveResult, type AuditLog, type AuditSink, type Sandbox, type SecretStore, type MemoryStore, type EventBus, type CIPipeline } from '@ai-sdlc/reference';
 /**
  * Create an adapter registry pre-loaded with all built-in and community adapters.
  */
@@ -55,6 +56,20 @@ 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';
+/**
+ * Resolve an IssueTracker from the adapterBindings in config.
+ *
+ * - 0 bindings → falls back to GitHub IssueTracker
+ * - 1 binding → returns that tracker directly
+ * - N bindings → wraps in CompositeIssueTracker
+ */
+export declare function resolveIssueTrackerFromConfig(config: AiSdlcConfig, fallbackGitHubConfig: {
+    org: string;
+    repo: string;
+    token: {
+        secretRef: string;
+    };
+}): IssueTracker;
+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, createCompositeIssueTracker, 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, CompositeIssueTrackerConfig, BackendRoute, } from '@ai-sdlc/reference';
 //# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.js

@@ -14,12 +14,22 @@ createStubCodeAnalysis, createStubMessenger, createStubDeploymentTarget, createS
 createInMemoryAuditSink, createFileSink, createAuditLog, createEnvSecretStore, createInMemoryMemoryStore, createInProcessEventBus, createStubSandbox, 
 // Docker sandbox
 createDockerSandbox, 
+// OpenShell sandbox
+createOpenShellSandbox, 
+// Backlog.md adapter
+createBacklogMdIssueTracker, 
 // Webhook bridge (used in function body)
 createWebhookBridge, 
 // Git resolver (used in function bodies)
 createStubGitAdapterFetcher, createGitAdapterFetcher, resolveGitAdapter, 
 // GitHub CI adapter
-createGitHubCIPipeline, } from '@ai-sdlc/reference';
+createGitHubCIPipeline, 
+// GitHub issue tracker
+createGitHubIssueTracker, 
+// Composite issue tracker
+createCompositeIssueTracker, 
+// Production adapters (for resolveIssueTrackerFromConfig)
+createJiraIssueTracker, createLinearIssueTracker, } from '@ai-sdlc/reference';
 /**
  * Create an adapter registry pre-loaded with all built-in and community adapters.
  */
@@ -45,6 +55,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
@@ -66,6 +77,24 @@ export function createPipelineAdapterRegistry() {
         };
         return createDockerSandbox(exec, config);
     });
+    registry.register(stubMeta('openshell-sandbox', 'OpenShell Sandbox', 'Sandbox@v1', 'openshell'), () => {
+        const exec = async (cmd) => {
+            const { exec: cpExec } = await import('node:child_process');
+            const { promisify } = await import('node:util');
+            const execAsync = promisify(cpExec);
+            const { stdout } = await execAsync(cmd);
+            return stdout;
+        };
+        const config = {
+            workDir: process.env.AI_SDLC_WORK_DIR,
+            binaryPath: process.env.AI_SDLC_OPENSHELL_BIN,
+            autoProviders: [
+                { name: 'claude', type: 'claude' },
+                { name: 'github', type: 'github' },
+            ],
+        };
+        return createOpenShellSandbox(exec, config);
+    });
     registry.register(stubMeta('env-secret-store', 'Environment Secret Store', 'SecretStore@v1', 'env'), () => createEnvSecretStore());
     registry.register(stubMeta('memory-store', 'In-Memory Memory Store', 'MemoryStore@v1', 'memory'), () => createInMemoryMemoryStore());
     registry.register(stubMeta('in-process-event-bus', 'In-Process Event Bus', 'EventBus@v1', 'in-process'), () => createInProcessEventBus());
@@ -84,7 +113,12 @@ export function resolveInfrastructure(registry, config) {
     const auditLog = createAuditLog(auditSink);
     // Resolve from registry — factories are guaranteed present when using
     // createPipelineAdapterRegistry(), but we guard for custom registries.
-    const sandboxProvider = process.env.AI_SDLC_SANDBOX_PROVIDER === 'docker' ? 'docker-sandbox' : 'stub-sandbox';
+    const sandboxEnv = process.env.AI_SDLC_SANDBOX_PROVIDER;
+    const sandboxProvider = sandboxEnv === 'openshell'
+        ? 'openshell-sandbox'
+        : sandboxEnv === 'docker'
+            ? 'docker-sandbox'
+            : 'stub-sandbox';
     const sandbox = registry.getFactory(sandboxProvider)?.() ?? createStubSandbox();
     const secretStore = registry.getFactory('env-secret-store')?.() ??
         createEnvSecretStore();
@@ -137,12 +171,71 @@ export function createPipelineCIAdapter() {
         workflowFile: process.env.AI_SDLC_WORKFLOW_FILE ?? DEFAULT_WORKFLOW_FILE,
     });
 }
+// ── Issue tracker resolution from config ────────────────────────────
+/**
+ * Resolve an IssueTracker from the adapterBindings in config.
+ *
+ * - 0 bindings → falls back to GitHub IssueTracker
+ * - 1 binding → returns that tracker directly
+ * - N bindings → wraps in CompositeIssueTracker
+ */
+export function resolveIssueTrackerFromConfig(config, fallbackGitHubConfig) {
+    const bindings = (config.adapterBindings ?? []).filter((b) => b.spec.interface === 'IssueTracker');
+    if (bindings.length === 0) {
+        return createGitHubIssueTracker(fallbackGitHubConfig);
+    }
+    const backends = bindings.map((binding) => {
+        const cfg = binding.spec.config ?? {};
+        switch (binding.spec.type) {
+            case 'backlog-md':
+                return {
+                    prefix: cfg.taskPrefix ?? 'AISDLC',
+                    adapter: createBacklogMdIssueTracker({
+                        backlogDir: cfg.backlogDir ?? './backlog',
+                        taskPrefix: cfg.taskPrefix,
+                    }),
+                };
+            case 'github':
+                return {
+                    prefix: null,
+                    adapter: createGitHubIssueTracker({
+                        org: cfg.org ?? fallbackGitHubConfig.org,
+                        repo: cfg.repo ?? fallbackGitHubConfig.repo,
+                        token: fallbackGitHubConfig.token,
+                    }),
+                };
+            case 'jira':
+                return {
+                    prefix: cfg.projectKey ?? null,
+                    adapter: createJiraIssueTracker(cfg),
+                };
+            case 'linear':
+                return {
+                    prefix: cfg.teamKey ?? null,
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    adapter: createLinearIssueTracker(cfg),
+                };
+            default:
+                // Unknown type — fall back to GitHub
+                return {
+                    prefix: null,
+                    adapter: createGitHubIssueTracker(fallbackGitHubConfig),
+                };
+        }
+    });
+    if (backends.length === 1) {
+        return backends[0].adapter;
+    }
+    return createCompositeIssueTracker({ backends });
+}
 // Direct re-exports (passthrough)
 export { 
 // Core adapters
 createGitHubCIPipeline, createDockerSandbox, createLinearIssueTracker, resolveSecret, 
 // Production adapters
 createGitLabSourceControl, createGitLabCIPipeline, createJiraIssueTracker, 
+// Backlog.md adapter
+createBacklogMdIssueTracker, 
 // Webhook server
 createWebhookServer, 
 // Webhook providers
@@ -153,6 +246,8 @@ createAdapterRegistry, validateAdapterMetadata, parseMetadataYaml, scanLocalAdap
 createStubCodeAnalysis, createStubMessenger, createStubDeploymentTarget, createStubGitLabCI, createStubGitLabSource, createStubJira, createStubBitbucket, createStubSonarQube, createStubSemgrep, 
 // Infrastructure adapter stubs
 createInMemoryAuditSink, createFileSink, createEnvSecretStore, createInMemoryMemoryStore, createInProcessEventBus, createStubSandbox, 
+// Composite issue tracker
+createCompositeIssueTracker, 
 // Webhook bridge
 createWebhookBridge, 
 // Git resolver

package/dist/cli/commands/init.js

@@ -134,24 +134,20 @@ spec:
       action: demote-one-level
       cooldown: 2w
 `;
-const GITIGNORE_ENTRIES = [
-    '# AI-SDLC runtime artifacts',
-    '.ai-sdlc/state.db',
-    '.ai-sdlc/state/',
-    '.ai-sdlc/audit.jsonl',
-];
+const GITIGNORE_PATHS = ['.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));
+    // Only check path entries (not comments) to avoid duplicate blocks
+    const missing = GITIGNORE_PATHS.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';
+    const block = '\n# AI-SDLC runtime artifacts\n' + missing.join('\n') + '\n';
     appendFileSync(gitignorePath, block, 'utf-8');
     console.log(`${prefix}  updated .gitignore`);
 }

package/dist/cli/commands/run.js

@@ -6,7 +6,7 @@ import { Orchestrator } from '../../orchestrator.js';
 import { formatOutput } from '../formatters/index.js';
 export const runCommand = new Command('run')
     .description('Run the AI-SDLC pipeline for a specific issue')
-    .requiredOption('-i, --issue <number>', 'Issue number to process', parseInt)
+    .requiredOption('-i, --issue <id>', 'Issue ID to process')
     .option('--state <path>', 'SQLite state database path')
     .action(async (opts, cmd) => {
     const globalOpts = cmd.parent?.opts() ?? {};
@@ -19,7 +19,7 @@ export const runCommand = new Command('run')
         const result = await orchestrator.run(opts.issue);
         console.log(formatOutput(format, {
             type: 'run',
-            issueNumber: opts.issue,
+            issueId: opts.issue,
             prUrl: result.prUrl,
             filesChanged: result.filesChanged.length,
             promotionEligible: result.promotionEligible,

package/dist/config.d.ts

@@ -11,7 +11,10 @@ export interface AiSdlcConfig {
     agentRole?: AgentRole;
     qualityGate?: QualityGate;
     autonomyPolicy?: AutonomyPolicy;
+    /** @deprecated Use `adapterBindings` instead. Returns the first binding if any exist. */
     adapterBinding?: AdapterBinding;
+    /** All AdapterBinding resources found in the config directory. */
+    adapterBindings?: AdapterBinding[];
     adapterRegistry?: AdapterRegistry;
 }
 /**

package/dist/config.js

@@ -9,12 +9,12 @@ import { readFileSync, readdirSync, existsSync } from 'node:fs';
 import { resolve, join } from 'node:path';
 import { parse as parseYaml } from 'yaml';
 import { validateResource, createAdapterRegistry, scanLocalAdapters, } from '@ai-sdlc/reference';
+/** Resource kinds that allow only a single instance. */
 const KIND_KEY = {
     Pipeline: 'pipeline',
     AgentRole: 'agentRole',
     QualityGate: 'qualityGate',
     AutonomyPolicy: 'autonomyPolicy',
-    AdapterBinding: 'adapterBinding',
 };
 /**
  * Load all YAML files from the given directory, validate each against
@@ -39,11 +39,20 @@ export function loadConfig(configDir) {
             throw new Error(`Validation failed for ${file}:\n${msgs}`);
         }
         const resource = result.data;
-        const key = KIND_KEY[resource.kind];
-        if (key) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            config[key] = resource;
+        if (resource.kind === 'AdapterBinding') {
+            (config.adapterBindings ??= []).push(resource);
         }
+        else {
+            const key = KIND_KEY[resource.kind];
+            if (key) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                config[key] = resource;
+            }
+        }
+    }
+    // Backward compat: set adapterBinding to the first binding
+    if (config.adapterBindings?.length) {
+        config.adapterBinding = config.adapterBindings[0];
     }
     return config;
 }

package/dist/execute.d.ts

@@ -14,6 +14,7 @@ import type { CodebaseContext } from './analysis/types.js';
 import type { AutonomyTracker } from './autonomy-tracker.js';
 import { CostTracker } from './cost-tracker.js';
 import type { StateStore } from './state/store.js';
+import type { PriorityScore } from './priority.js';
 export interface PipelineResult {
     prUrl: string;
     filesChanged: string[];
@@ -73,9 +74,11 @@ export interface ExecuteOptions {
     costTracker?: CostTracker;
     /** StateStore for episodic context enrichment. */
     stateStore?: StateStore;
+    /** Priority score from PPA scoring (set by watch loop or caller). */
+    priorityScore?: PriorityScore;
 }
 /**
- * Execute the full AI-SDLC pipeline for a given issue number.
+ * Execute the full AI-SDLC pipeline for a given issue ID.
  */
-export declare function executePipeline(issueNumber: number, options?: ExecuteOptions): Promise<PipelineResult>;
+export declare function executePipeline(issueId: string, options?: ExecuteOptions): Promise<PipelineResult>;
 //# sourceMappingURL=execute.d.ts.map