@praneeth_54/agentdoctor 2.1.0 → 3.0.0

package/dist/cli/commands/start.js

@@ -0,0 +1,80 @@
+import { EXIT_CODES } from "../../types/index.js";
+import { initBrainStore, rebuildBrain, getBrainStatus } from "../../core/brain-cli/service.js";
+import { discoverProjectRoots } from "../../product/discovery/roots.js";
+import { buildProjectDna, persistProjectDna } from "../../product/dna/build.js";
+import { resolveRepoRoot } from "../../utils/path.js";
+function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+export async function runStartCommand(options) {
+    const prefer = options.select ?? options.root;
+    const discovery = await discoverProjectRoots({
+        cwd: prefer ? resolveRepoRoot(prefer) : process.cwd(),
+        ...(prefer ? { prefer: resolveRepoRoot(prefer) } : {}),
+        ...(options.maxEntries !== undefined ? { maxEntries: options.maxEntries } : {}),
+        autoSelect: !options.listOnly,
+    });
+    if (options.listOnly || discovery.blocked || !discovery.selected) {
+        if (options.json) {
+            printJson({ discovery, dna: null, brain: null });
+            return discovery.blocked ? EXIT_CODES.USAGE_ERROR : EXIT_CODES.SUCCESS;
+        }
+        if (discovery.blocked) {
+            process.stderr.write(`Blocked: ${discovery.blockReason}\n`);
+            return EXIT_CODES.USAGE_ERROR;
+        }
+        process.stdout.write("Project candidates:\n");
+        if (discovery.candidates.length === 0) {
+            process.stdout.write("  (none found — navigate into a project or pass a path)\n");
+            return EXIT_CODES.USAGE_ERROR;
+        }
+        for (const [i, c] of discovery.candidates.entries()) {
+            process.stdout.write(`  [${i + 1}] ${c.root}\n      score=${c.score} markers=${c.markers.join(", ")} (${c.reason})\n`);
+        }
+        process.stdout.write("\nRe-run with --select <path> to initialize that project.\n");
+        return EXIT_CODES.SUCCESS;
+    }
+    const root = discovery.selected.root;
+    const dna = await persistProjectDna(root);
+    let brainStatus = null;
+    if (options.initBrain !== false) {
+        brainStatus = await initBrainStore(root);
+        if (options.rebuildBrain) {
+            await rebuildBrain(root);
+            brainStatus = await getBrainStatus(root);
+        }
+    }
+    const payload = { discovery, dna, brain: brainStatus };
+    if (options.json) {
+        printJson(payload);
+    }
+    else {
+        process.stdout.write(`AgentDoctor start\n`);
+        process.stdout.write(`  root: ${root}\n`);
+        process.stdout.write(`  fingerprint: ${dna.fingerprint}\n`);
+        process.stdout.write(`  type: ${dna.projectType}\n`);
+        process.stdout.write(`  languages: ${dna.languages.join(", ") || "(none)"}\n`);
+        process.stdout.write(`  frameworks: ${dna.frameworks.join(", ") || "(none)"}\n`);
+        process.stdout.write(`  files: ${dna.counts.files} (source ${dna.counts.sourceFiles}, tests ${dna.counts.testFiles})\n`);
+        if (brainStatus) {
+            process.stdout.write(`  brain: ${brainStatus.hasSnapshot ? `snapshot ${brainStatus.latestSnapshotId}` : "initialized (no snapshot yet — run with --rebuild-brain or brain rebuild)"}\n`);
+        }
+        process.stdout.write(`  DNA written to .agentdoctor/dna/project-dna.json\n`);
+    }
+    return EXIT_CODES.SUCCESS;
+}
+export async function runDnaCommand(options) {
+    const root = resolveRepoRoot(options.root ?? process.cwd());
+    const dna = options.persist ? await persistProjectDna(root) : await buildProjectDna(root);
+    if (options.json) {
+        printJson(dna);
+    }
+    else {
+        process.stdout.write(`Project DNA: ${dna.name} (${dna.fingerprint})\n`);
+        process.stdout.write(`  type: ${dna.projectType}\n`);
+        process.stdout.write(`  languages: ${dna.languages.join(", ") || "(none)"}\n`);
+        process.stdout.write(`  frameworks: ${dna.frameworks.join(", ") || "(none)"}\n`);
+        process.stdout.write(`  monorepo: ${dna.monorepo.isMonorepo ? dna.monorepo.tool : "no"}\n`);
+    }
+    return EXIT_CODES.SUCCESS;
+}

package/dist/cli/program.js

@@ -20,6 +20,8 @@ import { runWorkspaceCommand } from "./commands/workspace.js";
 import { runAskCommand, runChatCommand } from "./commands/chat.js";
 import { runAgentCommand, runPlanCommand } from "./commands/agent.js";
 import { runLearnCommand } from "./commands/learn.js";
+import { runProductCommand } from "./commands/product.js";
+import { runStartCommand, runDnaCommand } from "./commands/start.js";
 import { collectOpsHealth } from "../ops/health.js";
 import { listSessions, loadSession } from "../platform/sessions/store.js";
 import { exportReports } from "../platform/reports/export.js";
@@ -1282,6 +1284,7 @@ export function createProgram() {
         .option("--list-tools", "List available agent tools", false)
         .option("--tool <name>", "Run a single tool by name")
         .option("--goal <text>", "Build a change plan for this goal")
+        .option("--role <role>", "Specialized role for plan/apply (planner, coder, tester, reviewer, security, …)")
         .option("--approve", "Record explicit human approval", false)
         .option("--apply", "Apply approved changes (requires --approve)", false)
         .option("--apply-ops <json>", "JSON array of {name, arguments} tool ops for --apply")
@@ -1294,6 +1297,7 @@ export function createProgram() {
             listTools: Boolean(options.listTools),
             ...(options.tool !== undefined ? { tool: options.tool } : {}),
             ...(options.goal !== undefined ? { goal: options.goal } : {}),
+            ...(options.role !== undefined ? { role: options.role } : {}),
             approve: Boolean(options.approve),
             apply: Boolean(options.apply),
             ...(options.applyOps !== undefined ? { applyOpsJson: options.applyOps } : {}),
@@ -1543,6 +1547,143 @@ export function createProgram() {
         const code = await runExplainCommand(rule);
         process.exitCode = code;
     });
+    function bindProductCommand(name, description, action) {
+        program
+            .command(name)
+            .description(description)
+            .argument("[path]", "Repository path")
+            .option("--json", "Emit JSON report", false)
+            .action(async (pathArg, _options, command) => {
+            const options = command.optsWithGlobals();
+            process.exitCode = await runProductCommand({
+                action,
+                root: resolveTargetArgument(pathArg),
+                json: Boolean(options.json),
+            });
+        });
+    }
+    program
+        .command("start")
+        .description("Safe project discovery: detect project root, build Project DNA, initialize Project Brain")
+        .argument("[path]", "Optional project path (default: cwd)")
+        .option("--list", "List candidates without initializing", false)
+        .option("--select <path>", "Explicitly select a project root")
+        .option("--max-entries <n>", "Refuse scans larger than this entry budget", "25000")
+        .option("--no-init-brain", "Skip Project Brain store initialization")
+        .option("--rebuild-brain", "Compile Project Brain after init", false)
+        .option("--json", "Emit JSON", false)
+        .action(async (pathArg, options) => {
+        process.exitCode = await runStartCommand({
+            ...(pathArg !== undefined ? { root: resolveTargetArgument(pathArg) } : {}),
+            listOnly: Boolean(options.list),
+            ...(options.select !== undefined ? { select: options.select } : {}),
+            maxEntries: Number(options.maxEntries ?? 25000),
+            initBrain: options.initBrain !== false,
+            rebuildBrain: Boolean(options.rebuildBrain),
+            json: Boolean(options.json),
+        });
+    });
+    program
+        .command("dna")
+        .description("Build deterministic Project DNA fingerprint")
+        .argument("[path]", "Repository path")
+        .option("--persist", "Write .agentdoctor/dna/project-dna.json", false)
+        .option("--json", "Emit JSON", false)
+        .action(async (pathArg, options) => {
+        process.exitCode = await runDnaCommand({
+            root: resolveTargetArgument(pathArg),
+            persist: Boolean(options.persist),
+            json: Boolean(options.json),
+        });
+    });
+    bindProductCommand("requirements", "Trace requirements from markdown docs (evidence-backed)", "requirements");
+    bindProductCommand("api", "Discover HTTP route patterns (regex evidence)", "api");
+    bindProductCommand("database", "Discover schema objects from migrations/SQL/Prisma", "database");
+    bindProductCommand("events", "Detect queues, workers, cron, and event markers", "events");
+    bindProductCommand("dependency", "Analyze direct dependencies and workspace duplicates", "dependency");
+    bindProductCommand("deps", "Alias for dependency", "dependency");
+    bindProductCommand("health-code", "Aggregate code health indicators with evidence", "health-code");
+    bindProductCommand("code-health", "Alias for health-code", "health-code");
+    bindProductCommand("map", "Build navigable software map from project layout", "map");
+    bindProductCommand("decisions", "Load ADR files and decision ledger", "decisions");
+    bindProductCommand("forensic", "Read-only forensic analysis (git + ledgers + brain)", "forensic");
+    bindProductCommand("twin", "Software digital twin snapshot", "twin");
+    bindProductCommand("eval-lab", "Run evaluation lab fixture checks", "eval-lab");
+    bindProductCommand("self-check", "Self-diagnosis of AgentDoctor installation", "self-check");
+    bindProductCommand("infra", "Detect Docker/K8s/Terraform/CI artifacts", "infra");
+    bindProductCommand("incident", "Build incident timeline hypotheses", "incident");
+    bindProductCommand("security-doctor", "Security heuristics: secrets, auth markers, dangerous patterns", "security-doctor");
+    bindProductCommand("test-brain", "Test Brain: test-impact plus graph file↔test mapping", "test-brain");
+    bindProductCommand("privacy-doctor", "PII-ish pattern scan (not legal compliance)", "privacy-doctor");
+    bindProductCommand("tech-debt", "Technical debt roadmap (TODO/FIXME, architecture, tests)", "tech-debt");
+    bindProductCommand("features", "Feature intelligence (flows + API links)", "features");
+    bindProductCommand("evolution", "Software evolution timeline from git + ledger", "evolution");
+    bindProductCommand("org", "Load organization model (.agentdoctor/org)", "org");
+    program
+        .command("memory")
+        .description("Query institutional memory (brain + ledgers)")
+        .argument("<query>", "Memory query")
+        .argument("[path]", "Repository path")
+        .option("--json", "Emit JSON report", false)
+        .action(async (query, pathArg, _options, command) => {
+        const options = command.optsWithGlobals();
+        process.exitCode = await runProductCommand({
+            action: "memory",
+            query,
+            root: resolveTargetArgument(pathArg),
+            json: Boolean(options.json),
+        });
+    });
+    program
+        .command("search")
+        .description("Search symbols and concepts (brain + bounded file scan)")
+        .argument("<query>", "Search query")
+        .argument("[path]", "Repository path")
+        .option("--json", "Emit JSON report", false)
+        .action(async (query, pathArg, _options, command) => {
+        const options = command.optsWithGlobals();
+        process.exitCode = await runProductCommand({
+            action: "search",
+            query,
+            root: resolveTargetArgument(pathArg),
+            json: Boolean(options.json),
+        });
+    });
+    program
+        .command("role-agent")
+        .description("Run the coding loop with a specialized agent role")
+        .argument("[path]", "Repository path")
+        .requiredOption("--role <role>", "Agent role (planner, coder, tester, reviewer, security, …)")
+        .requiredOption("--goal <text>", "Goal for the role agent")
+        .option("--approve", "Record human approval for writes", false)
+        .option("--apply", "Apply changes (requires --approve)", false)
+        .option("--json", "Emit JSON", false)
+        .action(async (pathArg, options) => {
+        process.exitCode = await runProductCommand({
+            action: "role-agent",
+            root: resolveTargetArgument(pathArg),
+            role: options.role,
+            goal: options.goal,
+            approve: Boolean(options.approve),
+            apply: Boolean(options.apply),
+            json: Boolean(options.json),
+        });
+    });
+    program
+        .command("what-if")
+        .description("Graph-backed change impact for a file or symbol")
+        .argument("<target>", "File path or symbol")
+        .argument("[path]", "Repository path")
+        .option("--json", "Emit JSON report", false)
+        .action(async (target, pathArg, _options, command) => {
+        const options = command.optsWithGlobals();
+        process.exitCode = await runProductCommand({
+            action: "what-if",
+            root: resolveTargetArgument(pathArg),
+            target,
+            json: Boolean(options.json),
+        });
+    });
     program
         .command("doctor")
         .description("Check AgentDoctor installation health")

package/dist/constants.d.ts

@@ -1,5 +1,5 @@
 import type { AgentId } from "./types/index.js";
-export declare const PACKAGE_VERSION = "2.1.0";
+export declare const PACKAGE_VERSION = "3.0.0";
 export declare const DEFAULT_MAX_FILE_SIZE_BYTES: number;
 /** Directories skipped during normal discovery (unless a rule needs them later). */
 export declare const DEFAULT_IGNORE_DIRECTORIES: Set<string>;

package/dist/constants.js

@@ -1,4 +1,4 @@
-export const PACKAGE_VERSION = "2.1.0";
+export const PACKAGE_VERSION = "3.0.0";
 export const DEFAULT_MAX_FILE_SIZE_BYTES = 2 * 1024 * 1024; // 2 MiB
 /** Directories skipped during normal discovery (unless a rule needs them later). */
 export const DEFAULT_IGNORE_DIRECTORIES = new Set([

package/dist/dashboard/server.js

@@ -24,6 +24,25 @@ import { sanitizeForOutput } from "../utils/path.js";
 import { createModelProvider, loadAiConfig } from "../ai/index.js";
 import { ChatService } from "../agent/chat/service.js";
 import { formatChatResponseForCli } from "../agent/chat/response.js";
+import { buildProjectDna } from "../product/dna/build.js";
+import { buildSoftwareMap } from "../product/map/software-map.js";
+import { buildSoftwareDigitalTwin } from "../product/twin/store.js";
+import { analyzeCodeHealth } from "../product/health/code-health.js";
+import { traceRequirements } from "../product/requirements/trace.js";
+import { analyzeApiSurface } from "../product/api/doctor.js";
+import { analyzeDatabaseSchema } from "../product/database/doctor.js";
+import { analyzeEvents } from "../product/events/doctor.js";
+import { analyzeDependencies } from "../product/deps/analyze.js";
+import { analyzeSecuritySurface } from "../product/security/doctor.js";
+import { searchSymbolsAndConcepts } from "../product/search/software-search.js";
+import { analyzeWhatIf } from "../product/whatif/engine.js";
+import { runForensicAnalysis } from "../product/forensic/mode.js";
+import { buildIncidentHypotheses } from "../product/ops/incident.js";
+import { analyzeInfra } from "../product/ops/infra.js";
+import { analyzeFeatureIntelligence } from "../product/features/intelligence.js";
+import { buildSoftwareEvolutionTimeline } from "../product/evolution/timeline.js";
+import { queryMemory } from "../product/memory/institutional.js";
+import { loadDecisionLedger } from "../product/decisions/ledger.js";
 function safeJsonError(error) {
     const raw = error instanceof Error ? error.message : String(error);
     const { text } = redactSecrets(sanitizeForOutput(raw));
@@ -99,40 +118,104 @@ function htmlPage() {
   </header>
   <main>
     <nav aria-label="Views" style="display:flex;flex-wrap:wrap;gap:0.75rem;font-size:0.9rem">
-      <a href="#overview">Overview</a>
-      <a href="#scan">Safety scan</a>
-      <a href="#platform">Platform</a>
-      <a href="#brain">Brain</a>
+      <a href="#home">Home</a>
+      <a href="#dna">DNA</a>
       <a href="#graph">Graph</a>
-      <a href="#knowledge">Knowledge</a>
-      <a href="#chat">Project Chat</a>
-      <a href="#meta">Audit / baselines</a>
+      <a href="#chat">Chat</a>
+      <a href="#security">Security</a>
+      <a href="#twin">Twin</a>
+      <a href="#requirements">Requirements</a>
+      <a href="#map">Map</a>
+      <a href="#features">Features</a>
+      <a href="#deps">Deps</a>
+      <a href="#search">Search</a>
+      <a href="#whatif">What-if</a>
+      <a href="#forensic">Forensic</a>
+      <a href="#incident">Incident</a>
+      <a href="#infra">Infra</a>
+      <a href="#evolution">Evolution</a>
+      <a href="#memory">Memory</a>
+      <a href="#decisions">Decisions</a>
+      <a href="#health">Health</a>
+      <a href="#agent">Doctors</a>
     </nav>
-    <section id="overview">
-      <h2>Overview</h2>
+    <section id="home" data-route="home">
+      <h2>Home</h2>
       <pre id="status" class="muted">Loading…</pre>
     </section>
-    <section id="scan">
-      <h2>Safety scan</h2>
-      <pre id="scanBody" class="muted">Loading…</pre>
+    <section id="dna" data-route="dna" hidden>
+      <h2>Project DNA</h2>
+      <pre id="dnaBody" class="muted">Loading…</pre>
     </section>
-    <section id="platform">
-      <h2>Platform snapshot (incl. test-impact)</h2>
-      <pre id="platformBody" class="muted">Loading…</pre>
+    <section id="graph" data-route="graph" hidden>
+      <h2>Graph / Git / C4</h2>
+      <pre id="graphBody" class="muted">Loading…</pre>
     </section>
-    <section id="brain">
-      <h2>Project Brain</h2>
-      <pre id="brainBody" class="muted">Loading…</pre>
+    <section id="security" data-route="security" hidden>
+      <h2>Security doctor</h2>
+      <pre id="securityBody" class="muted">Loading…</pre>
     </section>
-    <section id="graph">
-      <h2>Intelligence graph / git / C4</h2>
-      <pre id="graphBody" class="muted">Loading…</pre>
+    <section id="twin" data-route="twin" hidden>
+      <h2>Digital twin</h2>
+      <pre id="twinBody" class="muted">Loading…</pre>
+    </section>
+    <section id="requirements" data-route="requirements" hidden>
+      <h2>Requirements trace</h2>
+      <pre id="requirementsBody" class="muted">Loading…</pre>
+    </section>
+    <section id="map" data-route="map" hidden>
+      <h2>Software map</h2>
+      <pre id="mapBody" class="muted">Loading…</pre>
+    </section>
+    <section id="features" data-route="features" hidden>
+      <h2>Feature intelligence</h2>
+      <pre id="featuresBody" class="muted">Loading…</pre>
+    </section>
+    <section id="deps" data-route="deps" hidden>
+      <h2>Dependencies</h2>
+      <pre id="depsBody" class="muted">Loading…</pre>
+    </section>
+    <section id="search" data-route="search" hidden>
+      <h2>Software search</h2>
+      <pre id="searchBody" class="muted">Loading…</pre>
+    </section>
+    <section id="whatif" data-route="whatif" hidden>
+      <h2>What-if</h2>
+      <pre id="whatifBody" class="muted">Loading…</pre>
+    </section>
+    <section id="forensic" data-route="forensic" hidden>
+      <h2>Forensic</h2>
+      <pre id="forensicBody" class="muted">Loading…</pre>
     </section>
-    <section id="knowledge">
-      <h2>Governed knowledge</h2>
-      <pre id="knowledgeBody" class="muted">Loading…</pre>
+    <section id="incident" data-route="incident" hidden>
+      <h2>Incident</h2>
+      <pre id="incidentBody" class="muted">Loading…</pre>
     </section>
-    <section id="chat">
+    <section id="infra" data-route="infra" hidden>
+      <h2>Infra</h2>
+      <pre id="infraBody" class="muted">Loading…</pre>
+    </section>
+    <section id="evolution" data-route="evolution" hidden>
+      <h2>Evolution</h2>
+      <pre id="evolutionBody" class="muted">Loading…</pre>
+    </section>
+    <section id="memory" data-route="memory" hidden>
+      <h2>Institutional memory</h2>
+      <pre id="memoryBody" class="muted">Loading…</pre>
+    </section>
+    <section id="decisions" data-route="decisions" hidden>
+      <h2>Decisions</h2>
+      <pre id="decisionsBody" class="muted">Loading…</pre>
+    </section>
+    <section id="health" data-route="health" hidden>
+      <h2>Code health</h2>
+      <pre id="healthBody" class="muted">Loading…</pre>
+    </section>
+    <section id="agent" data-route="agent" hidden>
+      <h2>Product doctors (API, DB, events)</h2>
+      <pre id="agentBody" class="muted">Loading…</pre>
+    </section>
+    <section id="chat" data-route="chat" hidden>
       <h2>Project Chat</h2>
       <p class="muted">Ask about this repository. Answers use evidence + truth labels. No file writes from this panel.</p>
       <div style="display:grid;grid-template-columns:1.4fr 1fr;gap:1rem">
@@ -147,30 +230,70 @@ function htmlPage() {
         </div>
       </div>
     </section>
-    <section id="meta">
-      <h2>Safe Fix audit / baselines / sessions</h2>
-      <pre id="metaBody" class="muted">Loading…</pre>
-    </section>
   </main>
   <script>
+    const routes = ['home','dna','graph','chat','security','twin','requirements','map','features','deps','search','whatif','forensic','incident','infra','evolution','memory','decisions','health','agent'];
+    function showRoute(name) {
+      const r = routes.includes(name) ? name : 'home';
+      for (const el of document.querySelectorAll('[data-route]')) {
+        el.hidden = el.getAttribute('data-route') !== r;
+      }
+      location.hash = r;
+    }
+    window.addEventListener('hashchange', () => showRoute((location.hash || '#home').slice(1)));
+    showRoute((location.hash || '#home').slice(1));
+
+    async function loadSection(route) {
+      const map = {
+        dna: [['dnaBody','/api/dna']],
+        graph: [['graphBody','/api/v2/graph']],
+        security: [['securityBody','/api/security']],
+        twin: [['twinBody','/api/twin']],
+        requirements: [['requirementsBody','/api/requirements']],
+        map: [['mapBody','/api/map']],
+        features: [['featuresBody','/api/features']],
+        deps: [['depsBody','/api/deps']],
+        search: [['searchBody','/api/search?q=main']],
+        whatif: [['whatifBody','/api/what-if?target=src']],
+        forensic: [['forensicBody','/api/forensic']],
+        incident: [['incidentBody','/api/incident']],
+        infra: [['infraBody','/api/infra']],
+        evolution: [['evolutionBody','/api/evolution']],
+        memory: [['memoryBody','/api/memory?q=change']],
+        decisions: [['decisionsBody','/api/decisions']],
+        health: [['healthBody','/api/health']],
+        agent: [['agentBody','/api/api-doctor']],
+      };
+      if (route === 'home') {
+        const [status, scan, brain, platform] = await Promise.all([
+          fetch('/api/status').then(r => r.json()),
+          fetch('/api/scan').then(r => r.json()),
+          fetch('/api/brain').then(r => r.json()),
+          fetch('/api/platform').then(r => r.json()),
+        ]);
+        document.getElementById('status').textContent = JSON.stringify({ status, scan, brain, platform }, null, 2);
+        return;
+      }
+      if (route === 'agent') {
+        const [api, db, events] = await Promise.all([
+          fetch('/api/api-doctor').then(r => r.json()),
+          fetch('/api/database').then(r => r.json()),
+          fetch('/api/events').then(r => r.json()),
+        ]);
+        document.getElementById('agentBody').textContent = JSON.stringify({ api, db, events }, null, 2);
+        return;
+      }
+      const loaders = map[route] || [];
+      for (const [elId, url] of loaders) {
+        const data = await fetch(url).then(r => r.json());
+        document.getElementById(elId).textContent = JSON.stringify(data, null, 2);
+      }
+    }
     async function load() {
-      const [status, scan, brain, meta, platform, graph, knowledge] = await Promise.all([
-        fetch('/api/status').then(r => r.json()),
-        fetch('/api/scan').then(r => r.json()),
-        fetch('/api/brain').then(r => r.json()),
-        fetch('/api/meta').then(r => r.json()),
-        fetch('/api/platform').then(r => r.json()),
-        fetch('/api/v2/graph').then(r => r.json()),
-        fetch('/api/v2/knowledge').then(r => r.json()),
-      ]);
-      document.getElementById('status').textContent = JSON.stringify(status, null, 2);
-      document.getElementById('scanBody').textContent = JSON.stringify(scan, null, 2);
-      document.getElementById('brainBody').textContent = JSON.stringify(brain, null, 2);
-      document.getElementById('metaBody').textContent = JSON.stringify(meta, null, 2);
-      document.getElementById('platformBody').textContent = JSON.stringify(platform, null, 2);
-      document.getElementById('graphBody').textContent = JSON.stringify(graph, null, 2);
-      document.getElementById('knowledgeBody').textContent = JSON.stringify(knowledge, null, 2);
+      const route = (location.hash || '#home').slice(1) || 'home';
+      await loadSection(route);
     }
+    window.addEventListener('hashchange', () => load().catch(err => console.error(err)));
     load().catch(err => {
       document.getElementById('status').textContent = String(err);
     });
@@ -246,14 +369,6 @@ export async function startDashboardServer(options) {
                     return;
                 }
                 const provider = options.chatProvider ?? createModelProvider(loadAiConfig());
-                if (provider.id === "none") {
-                    sendJson(res, 503, {
-                        error: "provider-none",
-                        message: "AI chat is not configured. Set AGENTDOCTOR_AI_PROVIDER to mock or an OpenAI-compatible provider. Silent mock fallback is disabled.",
-                        status: "provider-none",
-                    });
-                    return;
-                }
                 const chat = new ChatService({
                     root,
                     provider,
@@ -451,6 +566,93 @@ export async function startDashboardServer(options) {
                 });
                 return;
             }
+            if (url.pathname === "/api/dna") {
+                sendJson(res, 200, await buildProjectDna(root));
+                return;
+            }
+            if (url.pathname === "/api/map") {
+                sendJson(res, 200, await buildSoftwareMap(root));
+                return;
+            }
+            if (url.pathname === "/api/twin") {
+                sendJson(res, 200, await buildSoftwareDigitalTwin(root));
+                return;
+            }
+            if (url.pathname === "/api/health-code") {
+                sendJson(res, 200, await analyzeCodeHealth(root));
+                return;
+            }
+            if (url.pathname === "/api/requirements") {
+                sendJson(res, 200, await traceRequirements(root));
+                return;
+            }
+            if (url.pathname === "/api/api-doctor") {
+                sendJson(res, 200, await analyzeApiSurface(root));
+                return;
+            }
+            if (url.pathname === "/api/database") {
+                sendJson(res, 200, await analyzeDatabaseSchema(root));
+                return;
+            }
+            if (url.pathname === "/api/events") {
+                sendJson(res, 200, await analyzeEvents(root));
+                return;
+            }
+            if (url.pathname === "/api/deps") {
+                sendJson(res, 200, await analyzeDependencies(root));
+                return;
+            }
+            if (url.pathname === "/api/security") {
+                sendJson(res, 200, await analyzeSecuritySurface(root));
+                return;
+            }
+            if (url.pathname === "/api/search") {
+                const q = url.searchParams.get("q") ?? "";
+                sendJson(res, 200, await searchSymbolsAndConcepts(root, q));
+                return;
+            }
+            if (url.pathname === "/api/what-if") {
+                const target = url.searchParams.get("target") ?? "";
+                if (!target.trim()) {
+                    sendJson(res, 400, { error: "target query param required" });
+                    return;
+                }
+                sendJson(res, 200, await analyzeWhatIf(root, target));
+                return;
+            }
+            if (url.pathname === "/api/forensic") {
+                sendJson(res, 200, await runForensicAnalysis(root));
+                return;
+            }
+            if (url.pathname === "/api/incident") {
+                sendJson(res, 200, await buildIncidentHypotheses(root));
+                return;
+            }
+            if (url.pathname === "/api/infra") {
+                sendJson(res, 200, await analyzeInfra(root));
+                return;
+            }
+            if (url.pathname === "/api/features") {
+                sendJson(res, 200, await analyzeFeatureIntelligence(root));
+                return;
+            }
+            if (url.pathname === "/api/evolution") {
+                sendJson(res, 200, await buildSoftwareEvolutionTimeline(root));
+                return;
+            }
+            if (url.pathname === "/api/memory") {
+                const q = url.searchParams.get("q") ?? "";
+                sendJson(res, 200, await queryMemory(root, q));
+                return;
+            }
+            if (url.pathname === "/api/decisions") {
+                sendJson(res, 200, await loadDecisionLedger(root));
+                return;
+            }
+            if (url.pathname === "/api/health") {
+                sendJson(res, 200, await analyzeCodeHealth(root));
+                return;
+            }
             if (url.pathname === "/api/v2/projects" || url.pathname === "/api/v2/workspaces") {
                 sendJson(res, 200, {
                     mode: "local-single-repo",

package/dist/index.d.ts

@@ -62,4 +62,8 @@ export type { ChatTurnResponse, ChatServiceOptions, TruthClaim, ProjectChatSumma
 export { listAgentToolSpecs, getToolSpec, riskForTool, executeAgentTool, isReadTool, newToolCall, evaluateApproval, formatApprovalPrompt, buildAgentPlan, formatAgentPlan, approvePlan, runCodingLoop, verifyAgentWork, formatVerificationReport, } from "./agent/index.js";
 export type { AgentToolName, AgentToolSpec, AgentToolCall, AgentToolResult, AgentRiskLevel, ApprovalRequest, ApprovalResult, ApprovalDecision, AgentPlan, AgentPlanStep, CodingLoopOptions, CodingLoopResult, AgentVerificationReport, VerificationCheck, } from "./agent/index.js";
 export { getModeProfile, defaultStudentMode, parseAgentMode, modeAllowsMutation, modeBlocksToolCategory, StudentService, } from "./agent/index.js";
+export { traceRequirements, analyzeApiSurface, analyzeDatabaseSchema, analyzeEvents, analyzeDependencies, analyzeCodeHealth, buildSoftwareMap, appendChangeLedgerEntry, readChangeLedger, analyzeWhatIf, loadDecisionLedger, runForensicAnalysis, assertForensicReadOnly, buildSoftwareDigitalTwin, runEvalLab, diagnoseAgentDoctorSelf, analyzeInfra, buildIncidentHypotheses, enrichGraphWithLanguageAdapters, analyzeSecuritySurface, analyzePrivacySurface, searchSymbolsAndConcepts, buildTechnicalDebtRoadmap, loadOrganizationModel, saveOrganizationModel, linkProjectToOrgModel, analyzeFeatureIntelligence, buildSoftwareEvolutionTimeline, queryMemory, evaluateApprovalRecord, formatApprovalRecordSummary, issueApprovalGrant, consumeApprovalGrant, hashPlanPayload, hashFileWritePlan, minProductTruth, truthLabelDescription, } from "./product/index.js";
+export type { TruthLabel as ProductTruthLabel, ProductEvidence, RequirementsTraceReport, ApiDoctorReport, DatabaseDoctorReport, EventsDoctorReport, DependencyAnalysisReport, CodeHealthReport, SoftwareMap, ChangeLedgerEntry, WhatIfReport, DecisionRecord, ForensicAnalysisReport, SoftwareDigitalTwin, EvalLabReport, SelfDiagnoseReport, InfraReport, IncidentReport, LanguageGraphEnrichmentStats, SecurityDoctorReport, PrivacyDoctorReport, SoftwareSearchReport, TechnicalDebtRoadmap, OrganizationModel, FeatureIntelligenceReport, SoftwareEvolutionReport, InstitutionalMemoryQueryResult, ApprovalRecord, } from "./product/index.js";
+export { rolePrompt, roleAllowedTools, runRoleAgent } from "./agent/roles.js";
+export type { AgentRole, RoleAgentOptions } from "./agent/roles.js";
 export type { AgentMode, ModeProfile, StudentDocSection, BuildWithMeResult, } from "./agent/index.js";

package/dist/index.js

@@ -44,3 +44,5 @@ export { ChatService, createChatService, ChatMemory, CHAT_PROVIDER_NONE_MESSAGE,
 /** AgentDoctor 2.1 agent tools + plan (M3). */
 export { listAgentToolSpecs, getToolSpec, riskForTool, executeAgentTool, isReadTool, newToolCall, evaluateApproval, formatApprovalPrompt, buildAgentPlan, formatAgentPlan, approvePlan, runCodingLoop, verifyAgentWork, formatVerificationReport, } from "./agent/index.js";
 export { getModeProfile, defaultStudentMode, parseAgentMode, modeAllowsMutation, modeBlocksToolCategory, StudentService, } from "./agent/index.js";
+export { traceRequirements, analyzeApiSurface, analyzeDatabaseSchema, analyzeEvents, analyzeDependencies, analyzeCodeHealth, buildSoftwareMap, appendChangeLedgerEntry, readChangeLedger, analyzeWhatIf, loadDecisionLedger, runForensicAnalysis, assertForensicReadOnly, buildSoftwareDigitalTwin, runEvalLab, diagnoseAgentDoctorSelf, analyzeInfra, buildIncidentHypotheses, enrichGraphWithLanguageAdapters, analyzeSecuritySurface, analyzePrivacySurface, searchSymbolsAndConcepts, buildTechnicalDebtRoadmap, loadOrganizationModel, saveOrganizationModel, linkProjectToOrgModel, analyzeFeatureIntelligence, buildSoftwareEvolutionTimeline, queryMemory, evaluateApprovalRecord, formatApprovalRecordSummary, issueApprovalGrant, consumeApprovalGrant, hashPlanPayload, hashFileWritePlan, minProductTruth, truthLabelDescription, } from "./product/index.js";
+export { rolePrompt, roleAllowedTools, runRoleAgent } from "./agent/roles.js";