forge-ai-assist 1.0.0

package/README.md

@@ -0,0 +1,59 @@
+# Forge AI Assist
+
+Forge installs GitHub Copilot summonables and runs Forge-managed GitHub Discussions workflows from a local repository.
+
+## Install
+
+Run Forge directly without a global install:
+
+```bash
+npx forge-ai-assist@latest
+```
+
+After installation, Copilot should discover:
+
+- `forge-agent`
+- `forge-discussion-analyzer`
+
+The published binary name is:
+
+```bash
+forge
+```
+
+## Local Development
+
+From this repository:
+
+```bash
+npm install
+npm run build
+npm link
+forge
+```
+
+## GitHub Discussions
+
+Forge's discussions workflows require either `GH_TOKEN` or `GITHUB_TOKEN`:
+
+```bash
+export GH_TOKEN="$(gh auth token)"
+forge --fetch-discussions --when today
+forge --run-summonable forge-discussion-analyzer --question "What recurring issues show up this week?"
+```
+
+## Updating
+
+To use the latest published version:
+
+```bash
+npx forge-ai-assist@latest
+```
+
+To confirm the installed CLI version:
+
+```bash
+forge --version
+```
+
+Maintainer release steps live in [docs/releasing.md](/Users/ajitg/workspace/forge/docs/releasing.md).

package/dist/assets/copilot/agent.md

@@ -0,0 +1,24 @@
+# GitHub Copilot Forge Agent
+
+You are a repository planning agent that uses the Forge CLI to analyze and plan changes.
+
+## Commands
+
+### /plan
+Invoke this command to generate a structured action plan for the current repository.
+
+## Capabilities
+- **Repository Analysis**: Uses Forge to understand the tech stack and structure.
+- **Actionable Plans**: Provides a step-by-step list of changes to implement.
+- **Context-Aware**: Grounds recommendations in observed facts from the codebase.
+
+## Interaction Model
+When a user summons `/plan`, you will:
+1. Run `forge analyze` to gather repository facts.
+2. Run `forge plan` (via the planning engine) to generate recommendations.
+3. Present the plan as a clear list of implementation steps.
+
+## Principles
+- **Accuracy First**: Only suggest actions backed by analysis.
+- **Atomic Changes**: Break complex tasks into small, verifiable steps.
+- **Tool-Driven**: Leverage Forge's structured output for consistency.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { createProgram } from "./program.js";
+import { UserFacingError } from "./lib/errors.js";
+async function main() {
+    const program = await createProgram();
+    await program.parseAsync(process.argv);
+}
+try {
+    await main();
+}
+catch (error) {
+    if (error instanceof UserFacingError) {
+        console.error(error.message);
+        process.exitCode = 1;
+    }
+    else {
+        throw error;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,CAAC;IACH,MAAM,IAAI,EAAE,CAAC;AACf,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/commands/analyze.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Handles the repository analysis command.
+ *
+ * Performs an end-to-end analysis of the repository:
+ * 1. Confirms the current directory is within a Git repository.
+ * 2. Initializes or reuses the Forge sidecar.
+ * 3. Runs the analysis service (facts + recommendations).
+ * 4. Persists results and prints a summary.
+ */
+export declare function analyzeCommand(): Promise<void>;

package/dist/commands/analyze.js

@@ -0,0 +1,33 @@
+import { git } from "../services/git.js";
+import { runAnalysis } from "../services/analysis/run.js";
+import { initializeSidecar } from "../services/sidecar.js";
+import { deriveAnalysisPaths } from "../services/analysis/artifacts.js";
+import path from "node:path";
+/**
+ * Handles the repository analysis command.
+ *
+ * Performs an end-to-end analysis of the repository:
+ * 1. Confirms the current directory is within a Git repository.
+ * 2. Initializes or reuses the Forge sidecar.
+ * 3. Runs the analysis service (facts + recommendations).
+ * 4. Persists results and prints a summary.
+ */
+export async function analyzeCommand() {
+    // 1. Resolve the Git root (throws RepositoryRequiredError if not in a repo)
+    const repoRoot = await git.getRepoRoot();
+    // 2. Initialize the Forge sidecar (ensures directory exists)
+    const sidecar = await initializeSidecar(repoRoot);
+    // 3. Run analysis
+    console.log("Analyzing repository...");
+    const run = await runAnalysis(repoRoot);
+    // 4. Derive paths for reporting
+    const paths = deriveAnalysisPaths(sidecar);
+    const summaryPath = path.join(paths.base, "SUMMARY.md");
+    // 5. Print status summary
+    console.log("Analysis complete.");
+    console.log(`- ID: ${run.id}`);
+    console.log(`- Findings: ${run.recommendations.length} recommendations`);
+    console.log(`- Review summary: ${summaryPath}`);
+    console.log(`- Machine payload: ${paths.latest}`);
+}
+//# sourceMappingURL=analyze.js.map

package/dist/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;IAEzC,6DAA6D;IAC7D,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAElD,kBAAkB;IAClB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IAExC,gCAAgC;IAChC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAExD,0BAA0B;IAC1B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,eAAe,CAAC,MAAM,kBAAkB,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,qBAAqB,WAAW,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/commands/bootstrap.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Handles the repository bootstrap command.
+ *
+ * Performs the initial repository setup for Forge:
+ * 1. Confirms the current directory is within a Git repository.
+ * 2. Initializes or reuses the Forge sidecar directory (.forge).
+ * 3. Records the bootstrap run in metadata history.
+ * 4. Prints a concise success summary.
+ *
+ * This command respects the sidecar-only boundary and does not modify
+ * the host repository outside the .forge directory.
+ */
+export declare function bootstrapCommand(): Promise<void>;

package/dist/commands/bootstrap.js

@@ -0,0 +1,39 @@
+import { git } from "../services/git.js";
+import { initializeSidecar } from "../services/sidecar.js";
+import { writeMetadata } from "../services/metadata.js";
+/**
+ * Handles the repository bootstrap command.
+ *
+ * Performs the initial repository setup for Forge:
+ * 1. Confirms the current directory is within a Git repository.
+ * 2. Initializes or reuses the Forge sidecar directory (.forge).
+ * 3. Records the bootstrap run in metadata history.
+ * 4. Prints a concise success summary.
+ *
+ * This command respects the sidecar-only boundary and does not modify
+ * the host repository outside the .forge directory.
+ */
+export async function bootstrapCommand() {
+    // 1. Resolve the Git root (throws RepositoryRequiredError if not in a repo)
+    const repoRoot = await git.getRepoRoot();
+    // 2. Initialize the Forge sidecar (ensures directory exists)
+    const { sidecarPath, metadataPath, metadata } = await initializeSidecar(repoRoot);
+    // 3. Populate bootstrap-specific metadata and record history
+    const now = new Date().toISOString();
+    metadata.bootstrap = {
+        completedAt: now,
+        repoRootPath: repoRoot,
+    };
+    metadata.history.push({
+        type: "bootstrap",
+        timestamp: now,
+    });
+    // Ensure metadata updates are persisted
+    await writeMetadata(metadataPath, metadata);
+    // 4. Print status summary
+    console.log("Forge repository bootstrap successful.");
+    console.log(`- Repository: ${repoRoot}`);
+    console.log(`- Sidecar: ${sidecarPath}`);
+    console.log(`- Metadata: v${metadata.version}`);
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/commands/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/commands/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;IAEzC,6DAA6D;IAC7D,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAElF,6DAA6D;IAC7D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,QAAQ,CAAC,SAAS,GAAG;QACnB,WAAW,EAAE,GAAG;QAChB,YAAY,EAAE,QAAQ;KACvB,CAAC;IAEF,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;QACpB,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,GAAG;KACf,CAAC,CAAC;IAEH,wCAAwC;IACxC,MAAM,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAE5C,0BAA0B;IAC1B,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,cAAc,WAAW,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/commands/install-assistants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handles the CLI surface for installing the currently exposed Copilot summonables.
+ *
+ * Other assistant adapters remain in the codebase but are not exposed in the user-facing CLI yet.
+ */
+export declare function installAssistantsCommand(cwd: string): Promise<void>;

package/dist/commands/install-assistants.js

@@ -0,0 +1,46 @@
+import { assistantInstallService } from '../services/assistants/install.js';
+/**
+ * Handles the CLI surface for installing the currently exposed Copilot summonables.
+ *
+ * Other assistant adapters remain in the codebase but are not exposed in the user-facing CLI yet.
+ */
+export async function installAssistantsCommand(cwd) {
+    try {
+        const requestedAssistants = ['copilot'];
+        console.log('Installing Forge Copilot summonables...');
+        const results = await assistantInstallService.installDefaultSummonables(cwd, requestedAssistants);
+        console.log('\nAssistant Status Summary:');
+        console.log('-------------------------');
+        let hasSuccess = false;
+        for (const result of results) {
+            const statusIcon = getStatusIcon(result.status);
+            console.log(`${statusIcon} ${result.id.padEnd(10)}: ${result.message}`);
+            if (result.status === 'success' || result.status === 'skipped') {
+                hasSuccess = true;
+            }
+        }
+        if (hasSuccess) {
+            console.log('\nSuccess! Forge Copilot summonables are ready.');
+            console.log('You can now use Copilot /agent with forge-discussion-analyzer.');
+        }
+        else {
+            console.log('\nCopilot summonables were not installed or updated. Check the status messages above.');
+        }
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Maps operation status to a user-friendly CLI icon.
+ */
+function getStatusIcon(status) {
+    switch (status) {
+        case 'success': return '✅';
+        case 'skipped': return '⏭️ ';
+        case 'no-op': return '➖';
+        case 'failed': return '❌';
+        default: return '❓';
+    }
+}
+//# sourceMappingURL=install-assistants.js.map

package/dist/commands/install-assistants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-assistants.js","sourceRoot":"","sources":["../../src/commands/install-assistants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAG5E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,GAAW;IACxD,IAAI,CAAC;QACH,MAAM,mBAAmB,GAAkB,CAAC,SAAS,CAAC,CAAC;QAEvD,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAEvD,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,yBAAyB,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAElG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QAEzC,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/D,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,MAA0C;IAC/D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC;QAC3B,KAAK,SAAS,CAAC,CAAC,OAAO,KAAK,CAAC;QAC7B,KAAK,OAAO,CAAC,CAAG,OAAO,GAAG,CAAC;QAC3B,KAAK,QAAQ,CAAC,CAAE,OAAO,GAAG,CAAC;QAC3B,OAAO,CAAC,CAAQ,OAAO,GAAG,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/commands/install-copilot.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Handles the CLI surface for installing the GitHub Copilot proof.
+ *
+ * This command exposes a focused path for the Phase 3 proof of concept,
+ * allowing users to summon the native /agent workflow.
+ */
+export declare function installCopilotCommand(cwd: string): Promise<void>;

package/dist/commands/install-copilot.js

@@ -0,0 +1,30 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { copilotAdapter } from '../services/assistants/copilot.js';
+import { forgeAgentEntry } from '../services/assistants/forge-agent.js';
+/**
+ * Handles the CLI surface for installing the GitHub Copilot proof.
+ *
+ * This command exposes a focused path for the Phase 3 proof of concept,
+ * allowing users to summon the native /agent workflow.
+ */
+export async function installCopilotCommand(cwd) {
+    try {
+        console.log('Installing GitHub Copilot Forge adapter...');
+        // Resolve installation target and content
+        const targetPath = copilotAdapter.getInstallTarget(cwd, forgeAgentEntry);
+        const content = copilotAdapter.render(forgeAgentEntry);
+        // Ensure the target directory exists
+        await mkdir(path.dirname(targetPath), { recursive: true });
+        // Write the native entry asset
+        await writeFile(targetPath, content, 'utf8');
+        console.log(`Success! GitHub Copilot entrypoint written to: ${targetPath}`);
+        console.log('\nYou can now summon the Forge agent in Copilot via:');
+        console.log('  /plan - Generate a repository planning draft');
+    }
+    catch (error) {
+        console.error('Failed to install GitHub Copilot adapter:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=install-copilot.js.map

package/dist/commands/install-copilot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-copilot.js","sourceRoot":"","sources":["../../src/commands/install-copilot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAW;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAE1D,0CAA0C;QAC1C,MAAM,UAAU,GAAG,cAAc,CAAC,gBAAgB,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAEvD,qCAAqC;QACrC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3D,+BAA+B;QAC/B,MAAM,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE7C,OAAO,CAAC,GAAG,CAAC,kDAAkD,UAAU,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/plan.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Handles the planning command.
+ *
+ * Performs an end-to-end planning run:
+ * 1. Confirms the current directory is within a Git repository.
+ * 2. Initializes or reuses the Forge sidecar.
+ * 3. Runs the planning flow (grounded in latest analysis).
+ * 4. Persists results and prints a summary.
+ */
+export declare function planCommand(options: {
+    task?: string;
+    context?: string;
+}): Promise<void>;

package/dist/commands/plan.js

@@ -0,0 +1,34 @@
+import { git } from "../services/git.js";
+import { initializeSidecar } from "../services/sidecar.js";
+import { runPlanningFlow } from "../services/planning/run.js";
+import { derivePlanningPaths } from "../services/planning/artifacts.js";
+/**
+ * Handles the planning command.
+ *
+ * Performs an end-to-end planning run:
+ * 1. Confirms the current directory is within a Git repository.
+ * 2. Initializes or reuses the Forge sidecar.
+ * 3. Runs the planning flow (grounded in latest analysis).
+ * 4. Persists results and prints a summary.
+ */
+export async function planCommand(options) {
+    // 1. Resolve the Git root
+    const repoRoot = await git.getRepoRoot();
+    // 2. Initialize the Forge sidecar
+    const sidecar = await initializeSidecar(repoRoot);
+    // 3. Run planning
+    console.log("Generating action plan...");
+    const summary = await runPlanningFlow(sidecar, {
+        task: options.task,
+        discussionId: options.context,
+    });
+    // 4. Derive paths for reporting
+    const paths = derivePlanningPaths(sidecar);
+    // 5. Print status summary
+    console.log("Planning complete.");
+    console.log(`- ID: ${summary.id}`);
+    console.log(`- Reviewable plan: ${paths.latestMarkdown}`);
+    console.log(`- Machine payload: ${paths.latest}`);
+    console.log("\nForge has produced reviewable plans and did not mutate repository code automatically.");
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA4C;IAC5E,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;IAEzC,kCAAkC;IAClC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAElD,kBAAkB;IAClB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE;QAC7C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,OAAO,CAAC,OAAO;KAC9B,CAAC,CAAC;IAEH,gCAAgC;IAChC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE3C,0BAA0B;IAC1B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC;AACzG,CAAC"}

package/dist/config/analysis.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Analysis artifact subdirectory within the sidecar.
+ *
+ * All analysis-related data (historical runs, latest pointers)
+ * resides in this subdirectory of the `.forge` sidecar.
+ */
+export declare const ANALYSIS_SUBDIR = "analysis";
+/**
+ * Historical runs subdirectory within the analysis subtree.
+ *
+ * Stores the full AnalysisRun JSON artifacts named by their ID/timestamp.
+ */
+export declare const RUNS_SUBDIR = "runs";
+/**
+ * Stable pointer to the latest analysis run artifact.
+ *
+ * This file (or symlink, conceptually) allows Forge to find the most
+ * recent analysis without iterating through the history.
+ */
+export declare const LATEST_RUN_POINTER = "latest.json";
+/**
+ * Returns the relative path to the analysis subtree from the sidecar root.
+ */
+export declare const ANALYSIS_PATH = "analysis";
+export declare const DISCUSSIONS_SUBDIR = "discussions";
+export declare const DISCUSSION_RUNS_SUBDIR = "runs";
+export declare const LATEST_DISCUSSIONS_POINTER = "latest.json";
+export declare const DISCUSSION_ANALYSIS_SUBDIR = "analysis";
+export declare const LATEST_DISCUSSION_ANALYSIS_POINTER = "latest.json";

package/dist/config/analysis.js

@@ -0,0 +1,30 @@
+/**
+ * Analysis artifact subdirectory within the sidecar.
+ *
+ * All analysis-related data (historical runs, latest pointers)
+ * resides in this subdirectory of the `.forge` sidecar.
+ */
+export const ANALYSIS_SUBDIR = 'analysis';
+/**
+ * Historical runs subdirectory within the analysis subtree.
+ *
+ * Stores the full AnalysisRun JSON artifacts named by their ID/timestamp.
+ */
+export const RUNS_SUBDIR = 'runs';
+/**
+ * Stable pointer to the latest analysis run artifact.
+ *
+ * This file (or symlink, conceptually) allows Forge to find the most
+ * recent analysis without iterating through the history.
+ */
+export const LATEST_RUN_POINTER = 'latest.json';
+/**
+ * Returns the relative path to the analysis subtree from the sidecar root.
+ */
+export const ANALYSIS_PATH = ANALYSIS_SUBDIR;
+export const DISCUSSIONS_SUBDIR = 'discussions';
+export const DISCUSSION_RUNS_SUBDIR = 'runs';
+export const LATEST_DISCUSSIONS_POINTER = 'latest.json';
+export const DISCUSSION_ANALYSIS_SUBDIR = 'analysis';
+export const LATEST_DISCUSSION_ANALYSIS_POINTER = 'latest.json';
+//# sourceMappingURL=analysis.js.map

package/dist/config/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/config/analysis.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAC;AACxD,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAU,CAAC;AACrD,MAAM,CAAC,MAAM,kCAAkC,GAAG,aAAa,CAAC"}

package/dist/config/planning.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Planning artifact subdirectory within the sidecar.
+ */
+export declare const PLANNING_SUBDIR = "planning";
+/**
+ * Historical plans subdirectory within the planning subtree.
+ */
+export declare const PLANS_SUBDIR = "plans";
+/**
+ * Stable pointer to the latest plan run artifact.
+ */
+export declare const LATEST_PLAN_POINTER = "latest.json";
+/**
+ * Returns the relative path to the planning subtree from the sidecar root.
+ */
+export declare const PLANNING_PATH = "planning";

package/dist/config/planning.js

@@ -0,0 +1,17 @@
+/**
+ * Planning artifact subdirectory within the sidecar.
+ */
+export const PLANNING_SUBDIR = 'planning';
+/**
+ * Historical plans subdirectory within the planning subtree.
+ */
+export const PLANS_SUBDIR = 'plans';
+/**
+ * Stable pointer to the latest plan run artifact.
+ */
+export const LATEST_PLAN_POINTER = 'latest.json';
+/**
+ * Returns the relative path to the planning subtree from the sidecar root.
+ */
+export const PLANNING_PATH = PLANNING_SUBDIR;
+//# sourceMappingURL=planning.js.map

package/dist/config/planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../../src/config/planning.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC"}

package/dist/config/sidecar.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Canonical Forge sidecar directory name.
+ * Every Forge-managed repository contains exactly one such directory.
+ */
+export declare const SIDECAR_DIR_NAME = ".forge";
+/**
+ * Metadata filename within the sidecar.
+ */
+export declare const METADATA_FILENAME = "metadata.json";

package/dist/config/sidecar.js

@@ -0,0 +1,10 @@
+/**
+ * Canonical Forge sidecar directory name.
+ * Every Forge-managed repository contains exactly one such directory.
+ */
+export const SIDECAR_DIR_NAME = '.forge';
+/**
+ * Metadata filename within the sidecar.
+ */
+export const METADATA_FILENAME = 'metadata.json';
+//# sourceMappingURL=sidecar.js.map

package/dist/config/sidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.js","sourceRoot":"","sources":["../../src/config/sidecar.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC"}

package/dist/contracts/analysis.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Repository analysis run metadata and durable artifacts.
+ *
+ * This contract separates observed repository facts from inferred recommendations
+ * to ensure that planning logic can distinguish between what is definitively true
+ * about the repository and what is suggested by the analysis assistant.
+ */
+export interface RepositoryIdentity {
+    name: string;
+    remote?: string;
+    branch: string;
+    commitHash: string;
+}
+export interface TechnologyStack {
+    language: string;
+    frameworks: string[];
+    tools: string[];
+    packageManager?: string;
+}
+export interface FileSystemSummary {
+    directories: string[];
+    criticalFiles: string[];
+    entryPoints: string[];
+}
+export interface AssistantContextFindings {
+    hasInstructions: boolean;
+    hasCustomSkills: boolean;
+    instructionsPath?: string;
+    availableSkills: string[];
+}
+/**
+ * Observed Facts: Concrete evidence gathered from the repository.
+ */
+export interface ObservedFacts {
+    repository: RepositoryIdentity;
+    stack: TechnologyStack;
+    structure: FileSystemSummary;
+    assistantContext: AssistantContextFindings;
+    rawFindings: Record<string, any>;
+}
+/**
+ * Recommendations: Inferred guidance based on observed facts.
+ */
+export interface Recommendation {
+    id: string;
+    category: 'architecture' | 'implementation' | 'security' | 'performance' | 'convention';
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    description: string;
+    rationale: string;
+    suggestedAction?: string;
+}
+/**
+ * AnalysisRun: The complete durable artifact of a repository analysis session.
+ */
+export interface AnalysisRun {
+    /** Schema version for forward/backward compatibility */
+    version: '1.0';
+    /** Unique identifier for this analysis run (ISO timestamp) */
+    id: string;
+    /** When the analysis was performed */
+    timestamp: string;
+    /** Repository facts observed during the run */
+    observedFacts: ObservedFacts;
+    /** Inferred recommendations based on the observations */
+    recommendations: Recommendation[];
+}
+/**
+ * Summary pointer for metadata indexing.
+ */
+export interface AnalysisRunSummary {
+    id: string;
+    timestamp: string;
+    commitHash: string;
+    artifactPath: string;
+}

package/dist/contracts/analysis.js

@@ -0,0 +1,9 @@
+/**
+ * Repository analysis run metadata and durable artifacts.
+ *
+ * This contract separates observed repository facts from inferred recommendations
+ * to ensure that planning logic can distinguish between what is definitively true
+ * about the repository and what is suggested by the analysis assistant.
+ */
+export {};
+//# sourceMappingURL=analysis.js.map

package/dist/contracts/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/contracts/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/contracts/assistants.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Supported assistant identifiers and capability contracts.
+ */
+export type AssistantId = 'claude' | 'copilot' | 'codex' | 'gemini';
+export interface AssistantCapability {
+    /** Unique identifier for the assistant */
+    id: AssistantId;
+    /** Human-readable name of the assistant */
+    name: string;
+    /** Whether this assistant is currently supported in the runtime */
+    isSupported: boolean;
+    /** Primary installation target (e.g., '.github/copilot-instructions.md') */
+    installTarget: string;
+}
+export interface AssistantRegistryEntry {
+    id: AssistantId;
+    name: string;
+    description: string;
+    docsUrl?: string;
+}
+/**
+ * Result of an assistant availability check.
+ */
+export interface AssistantAvailability {
+    id: AssistantId;
+    isAvailable: boolean;
+    reason?: string;
+    requirement?: string;
+}
+/**
+ * Result of an assistant installation or update operation.
+ */
+export interface AssistantOperationResult {
+    id: AssistantId;
+    status: 'success' | 'skipped' | 'failed' | 'no-op';
+    message: string;
+    filePath?: string;
+}

package/dist/contracts/assistants.js

@@ -0,0 +1,5 @@
+/**
+ * Supported assistant identifiers and capability contracts.
+ */
+export {};
+//# sourceMappingURL=assistants.js.map

package/dist/contracts/assistants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistants.js","sourceRoot":"","sources":["../../src/contracts/assistants.ts"],"names":[],"mappings":"AAAA;;GAEG"}