devworkspace 0.0.0-stage → 0.1.0

package/dist/services/analysis.js

@@ -0,0 +1,151 @@
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { SCHEMA_VERSION, validateCommands } from '../config/schemas.js';
+import { TRUST_NOTE } from '../discovery/commands.js';
+import { detectProject } from '../discovery/detect.js';
+import { scanProject } from '../discovery/scan.js';
+import { getGitState } from '../git/git.js';
+import { detectIntegrations } from '../integrations/index.js';
+import { buildFact, loadFacts, saveFacts, upsertFact } from '../knowledge/facts.js';
+import { loadProject } from '../core/workspace.js';
+import { readVersioned, writeVersioned } from '../core/versioned.js';
+import { packageVersion } from '../core/version.js';
+import { pathExists, sha256Text, writeJsonIfChanged, writeTextIfChanged, atomicWriteJson } from '../utils/fs.js';
+import { isSensitiveFile } from '../security/files.js';
+import { buildOnboardingPrompt } from '../prompts/onboarding.js';
+import { claudeAdapter } from '../agents/claude/adapter.js';
+import { integrationCtx, isoNow } from './common.js';
+export async function runDiscovery(ws, projectName, maxFiles) {
+    const scan = await scanProject(ws.root, maxFiles ? { maxFiles } : {});
+    const [discovery, git] = await Promise.all([detectProject({ root: ws.root, projectName, scan }), getGitState(ws.root)]);
+    return {
+        discovery,
+        gitHead: git.head,
+        git: { isRepo: git.isRepo, branch: git.branch, dirty: git.dirty, changedFiles: git.entries.length },
+    };
+}
+function existingFiles(files, max = 10) {
+    return files.filter((f) => !isSensitiveFile(f)).slice(0, max);
+}
+/** Facts derived purely from deterministic detection. They are re-derived on every analyze/refresh. */
+export function detectorFacts(d) {
+    const out = [];
+    const add = (key, value, source, sources = []) => {
+        out.push({ key, value, source, sourceType: 'detector', sources, confidence: 'HIGH', status: 'DETECTED' });
+    };
+    const manifests = ['package.json', 'pyproject.toml', 'requirements.txt', 'go.mod', 'Cargo.toml', 'pom.xml', 'composer.json'];
+    const present = (f) => d.frameworks.some((x) => x.evidence === f) || d.commands.some((c) => c.source?.startsWith(f));
+    if (d.ecosystems.length > 0) {
+        add('stack.ecosystems', d.ecosystems.join(', '), 'repository manifests', manifests.filter(present));
+    }
+    if (d.languages.length > 0) {
+        add('stack.languages', d.languages.slice(0, 6).map((l) => `${l.name} (${l.files} files)`).join(', '), 'file extension counts');
+    }
+    if (d.packageManager)
+        add('stack.package-manager', d.packageManager, 'lockfiles / package manifests');
+    if (d.frameworks.length > 0) {
+        add('stack.frameworks', d.frameworks.map((f) => f.name).join(', '), 'dependency manifests', [...new Set(d.frameworks.map((f) => f.evidence))].slice(0, 10));
+    }
+    if (d.monorepo.tool) {
+        add('repo.monorepo', `${d.monorepo.tool}: ${d.monorepo.packages.map((p) => p.path).slice(0, 30).join(', ') || 'packages not enumerated'}`, 'workspace configuration');
+    }
+    if (d.ci.length > 0)
+        add('repo.ci', d.ci.join(', '), 'CI configuration', existingFiles(d.ci));
+    if (d.docker.length > 0)
+        add('repo.docker', d.docker.join(', '), 'container files', existingFiles(d.docker));
+    if (d.deployment.length > 0)
+        add('repo.deployment-hints', d.deployment.join(', '), 'deployment configuration', existingFiles(d.deployment));
+    if (d.testConfigs.length > 0)
+        add('repo.test-configs', d.testConfigs.join(', '), 'test configuration files', existingFiles(d.testConfigs));
+    if (d.aiInstructions.length > 0)
+        add('repo.ai-instructions', d.aiInstructions.join(', '), 'existing agent instruction files', existingFiles(d.aiInstructions));
+    return out;
+}
+export async function applyDetectorFacts(ws, d, now) {
+    const facts = await loadFacts(ws);
+    const written = [];
+    const skipped = [];
+    const keys = new Set();
+    for (const input of detectorFacts(d)) {
+        keys.add(input.key);
+        const existing = facts.facts.find((f) => f.key === input.key);
+        try {
+            const fact = await buildFact(ws.root, input, now, existing);
+            const action = upsertFact(facts, fact);
+            if (action !== 'unchanged')
+                written.push(input.key);
+        }
+        catch {
+            skipped.push(input.key);
+        }
+    }
+    // Detector facts that no longer apply are dropped: they are derived data, recreated if the evidence returns,
+    // and leaving them as STALE would produce a warning that no human or agent action can clear.
+    const retired = facts.facts.filter((f) => f.sourceType === 'detector' && !keys.has(f.key)).map((f) => f.key);
+    if (retired.length > 0)
+        facts.facts = facts.facts.filter((f) => !retired.includes(f.key));
+    await saveFacts(ws, facts);
+    return { written, skipped, retired };
+}
+export async function writeCommands(ws, detected) {
+    let previous = null;
+    if (await pathExists(ws.commands)) {
+        try {
+            previous = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data;
+        }
+        catch {
+            previous = null;
+        }
+    }
+    // Entries a human or the agent edited (origin "user") are never overwritten by detection.
+    const merged = detected.map((d) => previous?.checks.find((p) => p.id === d.id && p.origin === 'user') ?? d);
+    const file = { schemaVersion: SCHEMA_VERSION, trustNote: TRUST_NOTE, checks: merged };
+    validateCommands(file);
+    await writeVersioned(ws, ws.commands, file);
+    return true;
+}
+export async function analyzeWorkspace(ws, o) {
+    const project = await loadProject(ws);
+    const now = isoNow(o);
+    const run = await runDiscovery(ws, project.name, project.settings.maxFiles);
+    const integrations = await detectIntegrations(integrationCtx(o, ws.root));
+    const existingAgentFiles = await claudeAdapter.detectExisting(ws.root);
+    const prompt = buildOnboardingPrompt({
+        projectName: project.name,
+        discovery: run.discovery,
+        integrations,
+        git: run.git,
+        existingAgentFiles,
+        cliVersion: packageVersion(),
+    });
+    const rel = (p) => path.relative(ws.root, p).replace(/\\/g, '/');
+    const files = { discovery: rel(ws.discovery), onboardingPrompt: rel(ws.onboardingPrompt), commands: rel(ws.commands) };
+    const nextSteps = [
+        `Open ${files.onboardingPrompt}`,
+        'Paste it into Claude Code (or Claude in VS Code) in this project and let it finish onboarding.',
+        'Then run: devworkspace doctor',
+    ];
+    if (o.dryRun) {
+        return { dryRun: true, projectName: project.name, files, discovery: run.discovery, facts: { written: [], skipped: [], retired: [] }, integrations, promptBytes: prompt.length, nextSteps };
+    }
+    await writeJsonIfChanged(ws.discovery, run.discovery);
+    await writeCommands(ws, run.discovery.commands);
+    const facts = await applyDetectorFacts(ws, run.discovery, now);
+    await writeTextIfChanged(ws.onboardingPrompt, prompt);
+    await atomicWriteJson(ws.integrationsState, { schemaVersion: SCHEMA_VERSION, detectedAt: now, integrations });
+    const state = {
+        schemaVersion: SCHEMA_VERSION,
+        analyzedAt: now,
+        refreshedAt: null,
+        gitHead: run.gitHead,
+        fileCount: run.discovery.scan.fileCount,
+        truncated: run.discovery.scan.truncated,
+        discoveryHash: sha256Text(JSON.stringify(run.discovery)),
+    };
+    await writeVersioned(ws, ws.analysisState, state);
+    return { dryRun: false, projectName: project.name, files, discovery: run.discovery, facts, integrations, promptBytes: prompt.length, nextSteps };
+}
+export function newProjectId() {
+    return randomUUID();
+}
+//# sourceMappingURL=analysis.js.map

package/dist/services/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/services/analysis.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'node:path';\nimport { randomUUID } from 'node:crypto';\nimport { SCHEMA_VERSION, validateCommands, type AnalysisState, type CommandEntry, type CommandsFile } from '../config/schemas.js';\nimport { TRUST_NOTE } from '../discovery/commands.js';\nimport { detectProject, type DiscoveryReport } from '../discovery/detect.js';\nimport { scanProject } from '../discovery/scan.js';\nimport { getGitState } from '../git/git.js';\nimport { detectIntegrations } from '../integrations/index.js';\nimport { buildFact, loadFacts, saveFacts, upsertFact, type FactInput } from '../knowledge/facts.js';\nimport { loadProject } from '../core/workspace.js';\nimport { readVersioned, writeVersioned } from '../core/versioned.js';\nimport { packageVersion } from '../core/version.js';\nimport { pathExists, sha256Text, writeJsonIfChanged, writeTextIfChanged, atomicWriteJson } from '../utils/fs.js';\nimport { isSensitiveFile } from '../security/files.js';\nimport { buildOnboardingPrompt } from '../prompts/onboarding.js';\nimport { claudeAdapter } from '../agents/claude/adapter.js';\nimport type { Ws } from '../core/workspace.js';\nimport { integrationCtx, isoNow, type ServiceOptions } from './common.js';\n\nexport interface DiscoveryRun {\n  discovery: DiscoveryReport;\n  gitHead: string | null;\n  git: { isRepo: boolean; branch: string | null; dirty: boolean; changedFiles: number };\n}\n\nexport async function runDiscovery(ws: Ws, projectName: string, maxFiles?: number): Promise<DiscoveryRun> {\n  const scan = await scanProject(ws.root, maxFiles ? { maxFiles } : {});\n  const [discovery, git] = await Promise.all([detectProject({ root: ws.root, projectName, scan }), getGitState(ws.root)]);\n  return {\n    discovery,\n    gitHead: git.head,\n    git: { isRepo: git.isRepo, branch: git.branch, dirty: git.dirty, changedFiles: git.entries.length },\n  };\n}\n\nfunction existingFiles(files: string[], max = 10): string[] {\n  return files.filter((f) => !isSensitiveFile(f)).slice(0, max);\n}\n\n/** Facts derived purely from deterministic detection. They are re-derived on every analyze/refresh. */\nexport function detectorFacts(d: DiscoveryReport): FactInput[] {\n  const out: FactInput[] = [];\n  const add = (key: string, value: string, source: string, sources: string[] = []): void => {\n    out.push({ key, value, source, sourceType: 'detector', sources, confidence: 'HIGH', status: 'DETECTED' });\n  };\n  const manifests = ['package.json', 'pyproject.toml', 'requirements.txt', 'go.mod', 'Cargo.toml', 'pom.xml', 'composer.json'];\n  const present = (f: string): boolean => d.frameworks.some((x) => x.evidence === f) || d.commands.some((c) => c.source?.startsWith(f));\n  if (d.ecosystems.length > 0) {\n    add('stack.ecosystems', d.ecosystems.join(', '), 'repository manifests', manifests.filter(present));\n  }\n  if (d.languages.length > 0) {\n    add('stack.languages', d.languages.slice(0, 6).map((l) => `${l.name} (${l.files} files)`).join(', '), 'file extension counts');\n  }\n  if (d.packageManager) add('stack.package-manager', d.packageManager, 'lockfiles / package manifests');\n  if (d.frameworks.length > 0) {\n    add('stack.frameworks', d.frameworks.map((f) => f.name).join(', '), 'dependency manifests', [...new Set(d.frameworks.map((f) => f.evidence))].slice(0, 10));\n  }\n  if (d.monorepo.tool) {\n    add('repo.monorepo', `${d.monorepo.tool}: ${d.monorepo.packages.map((p) => p.path).slice(0, 30).join(', ') || 'packages not enumerated'}`, 'workspace configuration');\n  }\n  if (d.ci.length > 0) add('repo.ci', d.ci.join(', '), 'CI configuration', existingFiles(d.ci));\n  if (d.docker.length > 0) add('repo.docker', d.docker.join(', '), 'container files', existingFiles(d.docker));\n  if (d.deployment.length > 0) add('repo.deployment-hints', d.deployment.join(', '), 'deployment configuration', existingFiles(d.deployment));\n  if (d.testConfigs.length > 0) add('repo.test-configs', d.testConfigs.join(', '), 'test configuration files', existingFiles(d.testConfigs));\n  if (d.aiInstructions.length > 0) add('repo.ai-instructions', d.aiInstructions.join(', '), 'existing agent instruction files', existingFiles(d.aiInstructions));\n  return out;\n}\n\nexport async function applyDetectorFacts(ws: Ws, d: DiscoveryReport, now: string): Promise<{ written: string[]; skipped: string[]; retired: string[] }> {\n  const facts = await loadFacts(ws);\n  const written: string[] = [];\n  const skipped: string[] = [];\n  const keys = new Set<string>();\n  for (const input of detectorFacts(d)) {\n    keys.add(input.key);\n    const existing = facts.facts.find((f) => f.key === input.key);\n    try {\n      const fact = await buildFact(ws.root, input, now, existing);\n      const action = upsertFact(facts, fact);\n      if (action !== 'unchanged') written.push(input.key);\n    } catch {\n      skipped.push(input.key);\n    }\n  }\n  // Detector facts that no longer apply are dropped: they are derived data, recreated if the evidence returns,\n  // and leaving them as STALE would produce a warning that no human or agent action can clear.\n  const retired = facts.facts.filter((f) => f.sourceType === 'detector' && !keys.has(f.key)).map((f) => f.key);\n  if (retired.length > 0) facts.facts = facts.facts.filter((f) => !retired.includes(f.key));\n  await saveFacts(ws, facts);\n  return { written, skipped, retired };\n}\n\nexport async function writeCommands(ws: Ws, detected: CommandEntry[]): Promise<boolean> {\n  let previous: CommandsFile | null = null;\n  if (await pathExists(ws.commands)) {\n    try {\n      previous = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data;\n    } catch {\n      previous = null;\n    }\n  }\n  // Entries a human or the agent edited (origin \"user\") are never overwritten by detection.\n  const merged = detected.map((d) => previous?.checks.find((p) => p.id === d.id && p.origin === 'user') ?? d);\n  const file: CommandsFile = { schemaVersion: SCHEMA_VERSION, trustNote: TRUST_NOTE, checks: merged };\n  validateCommands(file);\n  await writeVersioned(ws, ws.commands, file);\n  return true;\n}\n\nexport interface AnalyzeResult {\n  dryRun: boolean;\n  projectName: string;\n  files: { discovery: string; onboardingPrompt: string; commands: string };\n  discovery: DiscoveryReport;\n  facts: { written: string[]; skipped: string[]; retired: string[] };\n  integrations: Awaited<ReturnType<typeof detectIntegrations>>;\n  promptBytes: number;\n  nextSteps: string[];\n}\n\nexport async function analyzeWorkspace(ws: Ws, o: ServiceOptions): Promise<AnalyzeResult> {\n  const project = await loadProject(ws);\n  const now = isoNow(o);\n  const run = await runDiscovery(ws, project.name, project.settings.maxFiles);\n  const integrations = await detectIntegrations(integrationCtx(o, ws.root));\n  const existingAgentFiles = await claudeAdapter.detectExisting(ws.root);\n  const prompt = buildOnboardingPrompt({\n    projectName: project.name,\n    discovery: run.discovery,\n    integrations,\n    git: run.git,\n    existingAgentFiles,\n    cliVersion: packageVersion(),\n  });\n  const rel = (p: string): string => path.relative(ws.root, p).replace(/\\\\/g, '/');\n  const files = { discovery: rel(ws.discovery), onboardingPrompt: rel(ws.onboardingPrompt), commands: rel(ws.commands) };\n  const nextSteps = [\n    `Open ${files.onboardingPrompt}`,\n    'Paste it into Claude Code (or Claude in VS Code) in this project and let it finish onboarding.',\n    'Then run: devworkspace doctor',\n  ];\n  if (o.dryRun) {\n    return { dryRun: true, projectName: project.name, files, discovery: run.discovery, facts: { written: [], skipped: [], retired: [] }, integrations, promptBytes: prompt.length, nextSteps };\n  }\n\n  await writeJsonIfChanged(ws.discovery, run.discovery);\n  await writeCommands(ws, run.discovery.commands);\n  const facts = await applyDetectorFacts(ws, run.discovery, now);\n  await writeTextIfChanged(ws.onboardingPrompt, prompt);\n  await atomicWriteJson(ws.integrationsState, { schemaVersion: SCHEMA_VERSION, detectedAt: now, integrations });\n  const state: AnalysisState = {\n    schemaVersion: SCHEMA_VERSION,\n    analyzedAt: now,\n    refreshedAt: null,\n    gitHead: run.gitHead,\n    fileCount: run.discovery.scan.fileCount,\n    truncated: run.discovery.scan.truncated,\n    discoveryHash: sha256Text(JSON.stringify(run.discovery)),\n  };\n  await writeVersioned(ws, ws.analysisState, state);\n  return { dryRun: false, projectName: project.name, files, discovery: run.discovery, facts, integrations, promptBytes: prompt.length, nextSteps };\n}\n\nexport function newProjectId(): string {\n  return randomUUID();\n}\n"]}

package/dist/services/common.d.ts

@@ -0,0 +1,18 @@
+import type { IntegrationContext } from '../integrations/types.js';
+import { type Ws } from '../core/workspace.js';
+export interface ServiceOptions {
+    /** Directory the command was started in. */
+    cwd: string;
+    dryRun?: boolean;
+    /** Injectable clock for deterministic tests. */
+    now?: () => Date;
+    /** Injectable integration context (home directory, PATH lookup) for tests. */
+    integrationContext?: (root: string) => IntegrationContext;
+    homeDir?: string;
+    /** Environment used for PATH lookups (defaults to process.env). */
+    env?: NodeJS.ProcessEnv;
+}
+export declare function isoNow(o: ServiceOptions): string;
+export declare function integrationCtx(o: ServiceOptions, root: string): IntegrationContext;
+/** Resolve the workspace and run a mutation under the workspace lock. */
+export declare function mutate<T>(o: ServiceOptions, fn: (ws: Ws) => Promise<T>): Promise<T>;

package/dist/services/common.js

@@ -0,0 +1,18 @@
+import os from 'node:os';
+import { defaultIntegrationContext } from '../integrations/index.js';
+import { requireWorkspace } from '../core/workspace.js';
+import { withLock } from '../utils/lock.js';
+export function isoNow(o) {
+    return (o.now ? o.now() : new Date()).toISOString();
+}
+export function integrationCtx(o, root) {
+    if (o.integrationContext)
+        return o.integrationContext(root);
+    return defaultIntegrationContext(root, o.env ?? process.env, o.homeDir ?? os.homedir());
+}
+/** Resolve the workspace and run a mutation under the workspace lock. */
+export async function mutate(o, fn) {
+    const ws = await requireWorkspace(o.cwd);
+    return withLock(ws.dir, () => fn(ws));
+}
+//# sourceMappingURL=common.js.map

package/dist/services/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/services/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAW,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAe5C,MAAM,UAAU,MAAM,CAAC,CAAiB;IACtC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAiB,EAAE,IAAY;IAC5D,IAAI,CAAC,CAAC,kBAAkB;QAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,CAAiB,EAAE,EAA0B;IAC3E,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import os from 'node:os';\nimport { defaultIntegrationContext } from '../integrations/index.js';\nimport type { IntegrationContext } from '../integrations/types.js';\nimport { requireWorkspace, type Ws } from '../core/workspace.js';\nimport { withLock } from '../utils/lock.js';\n\nexport interface ServiceOptions {\n  /** Directory the command was started in. */\n  cwd: string;\n  dryRun?: boolean;\n  /** Injectable clock for deterministic tests. */\n  now?: () => Date;\n  /** Injectable integration context (home directory, PATH lookup) for tests. */\n  integrationContext?: (root: string) => IntegrationContext;\n  homeDir?: string;\n  /** Environment used for PATH lookups (defaults to process.env). */\n  env?: NodeJS.ProcessEnv;\n}\n\nexport function isoNow(o: ServiceOptions): string {\n  return (o.now ? o.now() : new Date()).toISOString();\n}\n\nexport function integrationCtx(o: ServiceOptions, root: string): IntegrationContext {\n  if (o.integrationContext) return o.integrationContext(root);\n  return defaultIntegrationContext(root, o.env ?? process.env, o.homeDir ?? os.homedir());\n}\n\n/** Resolve the workspace and run a mutation under the workspace lock. */\nexport async function mutate<T>(o: ServiceOptions, fn: (ws: Ws) => Promise<T>): Promise<T> {\n  const ws = await requireWorkspace(o.cwd);\n  return withLock(ws.dir, () => fn(ws));\n}\n"]}

package/dist/services/doctor.d.ts

@@ -0,0 +1,27 @@
+import { type ServiceOptions } from './common.js';
+export type CheckStatus = 'pass' | 'warn' | 'fail' | 'info';
+export interface DoctorCheck {
+    id: string;
+    status: CheckStatus;
+    message: string;
+    remediation?: string;
+}
+export interface DoctorResult {
+    root: string | null;
+    checks: DoctorCheck[];
+    counts: {
+        pass: number;
+        warn: number;
+        fail: number;
+        info: number;
+    };
+    healthy: boolean;
+    ready: boolean;
+    fixed: string[];
+}
+export interface DoctorOptions extends ServiceOptions {
+    fix?: boolean;
+    minNodeMajor?: number;
+}
+export declare const MIN_NODE_MAJOR = 20;
+export declare function runDoctor(o: DoctorOptions): Promise<DoctorResult>;

package/dist/services/doctor.js

@@ -0,0 +1,223 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { SCHEMA_VERSION, validateAnalysisState, validateCommands } from '../config/schemas.js';
+import { findWorkspaceRoot, LOCAL_GITIGNORE, loadProject, wsPaths } from '../core/workspace.js';
+import { readVersioned } from '../core/versioned.js';
+import { getGitState, gitAvailable, gitTrackedFiles } from '../git/git.js';
+import { detectIntegrations } from '../integrations/index.js';
+import { loadFacts } from '../knowledge/facts.js';
+import { ONBOARDING_REQUIREMENTS, validatePrompt } from '../prompts/requirements.js';
+import { isSensitiveFile } from '../security/files.js';
+import { findSecrets } from '../security/redact.js';
+import { listDecisions } from '../decisions/decision.js';
+import { listTasks } from '../tasks/task.js';
+import { ensureDir, listFilesRecursive, pathExists, readTextBounded, atomicWriteFile } from '../utils/fs.js';
+import { findAbsolutePaths } from '../utils/paths.js';
+import { instructionsInstalled, knowledgeWritten } from './status.js';
+import { integrationCtx } from './common.js';
+import { withLock } from '../utils/lock.js';
+export const MIN_NODE_MAJOR = 20;
+export async function runDoctor(o) {
+    const checks = [];
+    const fixed = [];
+    const add = (id, status, message, remediation) => {
+        checks.push({ id, status, message, ...(remediation ? { remediation } : {}) });
+    };
+    const major = Number(process.versions.node.split('.')[0]);
+    const minNode = o.minNodeMajor ?? MIN_NODE_MAJOR;
+    if (major >= minNode)
+        add('node', 'pass', `Node.js ${process.versions.node}`);
+    else
+        add('node', 'fail', `Node.js ${process.versions.node} is older than the required ${minNode}`, `Install Node.js ${minNode} or newer (https://nodejs.org).`);
+    const hasGit = await gitAvailable();
+    if (hasGit)
+        add('git', 'pass', 'Git is available');
+    else
+        add('git', 'warn', 'Git was not found on PATH', 'Install Git; DevWorkspace works without it but cannot protect uncommitted changes.');
+    const root = await findWorkspaceRoot(o.cwd);
+    if (!root) {
+        if (await pathExists(path.join(o.cwd, '.devworkspace'))) {
+            add('workspace', 'fail', 'Partial initialization: .devworkspace/ exists but project.json is missing', 'Restore project.json from Git, or run "devworkspace init" to complete the setup (existing files are kept).');
+        }
+        else {
+            add('workspace', 'fail', 'No DevWorkspace found in this directory or any parent', 'Run: devworkspace init');
+        }
+        return finish(null, checks, fixed);
+    }
+    const ws = wsPaths(root);
+    add('workspace', 'pass', 'Workspace found');
+    // Project config and schema compatibility.
+    let projectOk = false;
+    try {
+        const p = await loadProject(ws);
+        projectOk = true;
+        add('project', 'pass', `project.json valid (schema v${p.schemaVersion}, id ${p.projectId.slice(0, 8)})`);
+    }
+    catch (e) {
+        const code = e.code;
+        add('project', 'fail', e.message.split('\n')[0], code === 'SCHEMA_TOO_NEW' ? 'Upgrade DevWorkspace: npm install -g devworkspace@latest' : 'Restore .devworkspace/project.json from Git, or re-run "devworkspace init" after moving the broken file away.');
+    }
+    // Layout.
+    const dirs = [ws.contextDir, ws.decisionsDir, ws.tasksActive, ws.tasksCompleted, ws.sessionsDir, ws.analysisDir, ws.stateDir];
+    const missingDirs = [];
+    for (const d of dirs)
+        if (!(await pathExists(d)))
+            missingDirs.push(d);
+    if (missingDirs.length === 0)
+        add('layout', 'pass', 'Workspace folders present');
+    else if (o.fix && projectOk) {
+        await withLock(ws.dir, async () => {
+            for (const d of missingDirs)
+                await ensureDir(d);
+        });
+        fixed.push(`created ${missingDirs.length} missing folder(s)`);
+        add('layout', 'pass', `Recreated ${missingDirs.length} missing folder(s)`);
+    }
+    else {
+        add('layout', 'warn', `Missing folders: ${missingDirs.map((d) => path.basename(d)).join(', ')}`, 'Run: devworkspace doctor --fix');
+    }
+    // Ignore rules.
+    const giOk = await fs.readFile(ws.gitignore, 'utf8').then((gi) => gi.split(/\r?\n/).some((l) => l.trim() === 'local/'), () => false);
+    if (giOk)
+        add('ignore-local', 'pass', 'Machine-local state is git-ignored');
+    else if (o.fix && projectOk) {
+        await atomicWriteFile(ws.gitignore, LOCAL_GITIGNORE);
+        fixed.push('wrote .devworkspace/.gitignore');
+        add('ignore-local', 'pass', 'Wrote .devworkspace/.gitignore');
+    }
+    else
+        add('ignore-local', 'fail', '.devworkspace/.gitignore does not ignore local/', 'Run: devworkspace doctor --fix');
+    try {
+        const rootGi = await fs.readFile(path.join(root, '.gitignore'), 'utf8');
+        if (rootGi.split(/\r?\n/).some((l) => /^\/?\.devworkspace\/?\*?$/.test(l.trim()))) {
+            add('ignore-root', 'warn', 'The root .gitignore ignores all of .devworkspace/, so project knowledge will not be shared', 'Remove that rule; .devworkspace/.gitignore already excludes machine-local files.');
+        }
+    }
+    catch {
+        /* no root .gitignore */
+    }
+    // Knowledge and contract.
+    try {
+        const facts = await loadFacts(ws);
+        const stale = facts.facts.filter((f) => f.status === 'STALE');
+        add('facts', 'pass', `${facts.facts.length} fact(s) stored`);
+        if (stale.length > 0)
+            add('staleness', 'warn', `${stale.length} stale fact(s): ${stale.slice(0, 5).map((f) => f.key).join(', ')}`, 'Run: devworkspace refresh');
+        else if (facts.facts.length > 0)
+            add('staleness', 'pass', 'No stale facts recorded');
+    }
+    catch (e) {
+        add('facts', 'fail', e.message.split('\n')[0], 'Restore .devworkspace/context/facts.json from Git or a backup under .devworkspace/local/backups.');
+    }
+    if (await pathExists(ws.commands)) {
+        try {
+            const c = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data;
+            add('contract', 'pass', 'Testing contract present');
+            const unit = c.checks.find((x) => x.id === 'unit');
+            if (!unit?.available)
+                add('tests-available', 'warn', 'No unit-test command detected', 'Add a test script or edit .devworkspace/context/commands.json; tasks will not be able to demand tests.');
+            if (!c.checks.some((x) => x.id === 'build' && x.available))
+                add('build-available', 'info', 'No build command detected');
+        }
+        catch (e) {
+            add('contract', 'fail', e.message.split('\n')[0], 'Fix commands.json or re-run: devworkspace analyze');
+        }
+    }
+    else
+        add('contract', 'warn', 'Testing contract not generated yet', 'Run: devworkspace analyze');
+    if (await pathExists(ws.analysisState)) {
+        try {
+            const a = (await readVersioned(ws.analysisState, 'analysis', SCHEMA_VERSION, validateAnalysisState)).data;
+            add('analysis', 'pass', `Last analysis ${a.analyzedAt}${a.truncated ? ' (partial: size limits hit)' : ''}`);
+        }
+        catch (e) {
+            add('analysis', 'fail', e.message.split('\n')[0], 'Re-run: devworkspace analyze');
+        }
+    }
+    else
+        add('analysis', 'warn', 'Repository has not been analyzed', 'Run: devworkspace analyze');
+    // Prompt quality (when present).
+    if (await pathExists(ws.onboardingPrompt)) {
+        const text = (await readTextBounded(ws.onboardingPrompt, 1024 * 1024)) ?? '';
+        const missing = validatePrompt(text, ONBOARDING_REQUIREMENTS);
+        if (missing.length === 0)
+            add('onboarding-prompt', 'pass', 'Onboarding prompt satisfies all behavioural requirements');
+        else
+            add('onboarding-prompt', 'fail', `Onboarding prompt is missing: ${missing.join(', ')}`, 'Re-run: devworkspace analyze');
+    }
+    // Agent wiring.
+    if (await instructionsInstalled(ws))
+        add('agent-instructions', 'pass', 'Claude instructions and skill installed');
+    else
+        add('agent-instructions', 'warn', 'Claude instructions are not installed (or the managed section is missing)', 'Run: devworkspace agent install');
+    if (await knowledgeWritten(ws))
+        add('onboarding', 'pass', 'Architecture knowledge written');
+    else
+        add('onboarding', 'warn', 'Onboarding is not complete: .devworkspace/context/architecture.md is missing or empty', 'Paste .devworkspace/analysis/onboarding-prompt.md into Claude Code.');
+    // Integrations.
+    for (const i of await detectIntegrations(integrationCtx(o, root))) {
+        if (i.state === 'READY')
+            add(`integration-${i.id}`, 'pass', `${i.name}: ready`);
+        else if (i.optional)
+            add(`integration-${i.id}`, 'info', `${i.name}: ${i.state.toLowerCase().replace('_', ' ')} (optional)`);
+        else
+            add(`integration-${i.id}`, 'warn', `${i.name}: ${i.state.toLowerCase().replace('_', ' ')}${i.details[0] ? ` - ${i.details[0]}` : ''}`, i.remediation[0]);
+    }
+    // Security and portability.
+    const wsFiles = (await listFilesRecursive(ws.dir, 3000)).filter((f) => !f.startsWith(ws.localDir) && !/\.tmp$/.test(f));
+    const secretHits = [];
+    const absHits = [];
+    for (const f of wsFiles) {
+        if (!/\.(json|md)$/.test(f))
+            continue;
+        const rel = path.relative(ws.dir, f).replace(/\\/g, '/');
+        const text = await readTextBounded(f, 1024 * 1024);
+        if (!text)
+            continue;
+        if (findSecrets(text).length > 0)
+            secretHits.push(rel);
+        if (rel !== 'analysis/onboarding-prompt.md' && rel !== 'analysis/refresh-prompt.md' && findAbsolutePaths(text).length > 0)
+            absHits.push(rel);
+    }
+    if (secretHits.length === 0)
+        add('secrets', 'pass', 'No secret-like values in .devworkspace');
+    else
+        add('secrets', 'fail', `Secret-like values found in: ${secretHits.join(', ')}`, 'Remove the values, rotate the credential if it was real, and re-run doctor.');
+    if (absHits.length === 0)
+        add('portability', 'pass', 'No machine-specific absolute paths in portable knowledge');
+    else
+        add('portability', 'warn', `Absolute paths found in: ${absHits.join(', ')}`, 'Replace them with project-relative paths so the workspace works after the project moves.');
+    const git = await getGitState(root);
+    if (git.isRepo) {
+        const tracked = await gitTrackedFiles(root);
+        const bad = (tracked ?? []).filter((f) => isSensitiveFile(f));
+        if (bad.length > 0)
+            add('tracked-secrets', 'warn', `Credential-like files are tracked by Git: ${bad.slice(0, 5).join(', ')}`, 'Remove them from Git history if they hold real secrets (git rm --cached, then rotate).');
+        else
+            add('tracked-secrets', 'pass', 'No credential-like files tracked by Git');
+    }
+    const leftovers = wsFiles.filter((f) => f.endsWith('.tmp'));
+    const allTmp = (await listFilesRecursive(ws.dir, 3000)).filter((f) => f.endsWith('.tmp'));
+    if (allTmp.length > 0 || leftovers.length > 0)
+        add('tmp-files', 'warn', `${allTmp.length} leftover temporary file(s) from an interrupted write`, 'They are safe to delete: ' + allTmp.slice(0, 3).map((f) => path.relative(root, f).replace(/\\/g, '/')).join(', '));
+    // Tasks and decisions.
+    const { tasks, corrupt } = await listTasks(ws, { includeCompleted: true });
+    if (corrupt.length > 0)
+        add('tasks', 'fail', `${corrupt.length} unreadable task file(s): ${corrupt.map((c) => c.file).join(', ')}`, 'Restore them from Git or delete the broken file.');
+    else
+        add('tasks', 'pass', `${tasks.length} task(s) readable`);
+    const dec = await listDecisions(ws);
+    if (dec.unreadable.length > 0)
+        add('decisions', 'warn', `Unreadable decision file(s): ${dec.unreadable.join(', ')}`, 'Check their front matter.');
+    return finish(root, checks, fixed, ws);
+}
+async function finish(root, checks, fixed, ws) {
+    const counts = { pass: 0, warn: 0, fail: 0, info: 0 };
+    for (const c of checks)
+        counts[c.status]++;
+    let ready = false;
+    if (ws)
+        ready = counts.fail === 0 && (await instructionsInstalled(ws)) && (await knowledgeWritten(ws));
+    return { root, checks, counts, healthy: counts.fail === 0, ready, fixed };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/services/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/services/doctor.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { SCHEMA_VERSION, validateAnalysisState, validateCommands } from '../config/schemas.js';\nimport { findWorkspaceRoot, LOCAL_GITIGNORE, loadProject, wsPaths, type Ws } from '../core/workspace.js';\nimport { readVersioned } from '../core/versioned.js';\nimport { getGitState, gitAvailable, gitTrackedFiles } from '../git/git.js';\nimport { detectIntegrations } from '../integrations/index.js';\nimport { loadFacts } from '../knowledge/facts.js';\nimport { ONBOARDING_REQUIREMENTS, validatePrompt } from '../prompts/requirements.js';\nimport { isSensitiveFile } from '../security/files.js';\nimport { findSecrets } from '../security/redact.js';\nimport { listDecisions } from '../decisions/decision.js';\nimport { listTasks } from '../tasks/task.js';\nimport { ensureDir, listFilesRecursive, pathExists, readTextBounded, atomicWriteFile } from '../utils/fs.js';\nimport { findAbsolutePaths } from '../utils/paths.js';\nimport { instructionsInstalled, knowledgeWritten } from './status.js';\nimport { integrationCtx, type ServiceOptions } from './common.js';\nimport { withLock } from '../utils/lock.js';\n\nexport type CheckStatus = 'pass' | 'warn' | 'fail' | 'info';\n\nexport interface DoctorCheck {\n  id: string;\n  status: CheckStatus;\n  message: string;\n  remediation?: string;\n}\n\nexport interface DoctorResult {\n  root: string | null;\n  checks: DoctorCheck[];\n  counts: { pass: number; warn: number; fail: number; info: number };\n  healthy: boolean;\n  ready: boolean;\n  fixed: string[];\n}\n\nexport interface DoctorOptions extends ServiceOptions {\n  fix?: boolean;\n  minNodeMajor?: number;\n}\n\nexport const MIN_NODE_MAJOR = 20;\n\nexport async function runDoctor(o: DoctorOptions): Promise<DoctorResult> {\n  const checks: DoctorCheck[] = [];\n  const fixed: string[] = [];\n  const add = (id: string, status: CheckStatus, message: string, remediation?: string): void => {\n    checks.push({ id, status, message, ...(remediation ? { remediation } : {}) });\n  };\n\n  const major = Number(process.versions.node.split('.')[0]);\n  const minNode = o.minNodeMajor ?? MIN_NODE_MAJOR;\n  if (major >= minNode) add('node', 'pass', `Node.js ${process.versions.node}`);\n  else add('node', 'fail', `Node.js ${process.versions.node} is older than the required ${minNode}`, `Install Node.js ${minNode} or newer (https://nodejs.org).`);\n\n  const hasGit = await gitAvailable();\n  if (hasGit) add('git', 'pass', 'Git is available');\n  else add('git', 'warn', 'Git was not found on PATH', 'Install Git; DevWorkspace works without it but cannot protect uncommitted changes.');\n\n  const root = await findWorkspaceRoot(o.cwd);\n  if (!root) {\n    if (await pathExists(path.join(o.cwd, '.devworkspace'))) {\n      add('workspace', 'fail', 'Partial initialization: .devworkspace/ exists but project.json is missing', 'Restore project.json from Git, or run \"devworkspace init\" to complete the setup (existing files are kept).');\n    } else {\n      add('workspace', 'fail', 'No DevWorkspace found in this directory or any parent', 'Run: devworkspace init');\n    }\n    return finish(null, checks, fixed);\n  }\n  const ws = wsPaths(root);\n  add('workspace', 'pass', 'Workspace found');\n\n  // Project config and schema compatibility.\n  let projectOk = false;\n  try {\n    const p = await loadProject(ws);\n    projectOk = true;\n    add('project', 'pass', `project.json valid (schema v${p.schemaVersion}, id ${p.projectId.slice(0, 8)})`);\n  } catch (e) {\n    const code = (e as { code?: string }).code;\n    add('project', 'fail', (e as Error).message.split('\\n')[0]!, code === 'SCHEMA_TOO_NEW' ? 'Upgrade DevWorkspace: npm install -g devworkspace@latest' : 'Restore .devworkspace/project.json from Git, or re-run \"devworkspace init\" after moving the broken file away.');\n  }\n\n  // Layout.\n  const dirs = [ws.contextDir, ws.decisionsDir, ws.tasksActive, ws.tasksCompleted, ws.sessionsDir, ws.analysisDir, ws.stateDir];\n  const missingDirs: string[] = [];\n  for (const d of dirs) if (!(await pathExists(d))) missingDirs.push(d);\n  if (missingDirs.length === 0) add('layout', 'pass', 'Workspace folders present');\n  else if (o.fix && projectOk) {\n    await withLock(ws.dir, async () => {\n      for (const d of missingDirs) await ensureDir(d);\n    });\n    fixed.push(`created ${missingDirs.length} missing folder(s)`);\n    add('layout', 'pass', `Recreated ${missingDirs.length} missing folder(s)`);\n  } else {\n    add('layout', 'warn', `Missing folders: ${missingDirs.map((d) => path.basename(d)).join(', ')}`, 'Run: devworkspace doctor --fix');\n  }\n\n  // Ignore rules.\n  const giOk = await fs.readFile(ws.gitignore, 'utf8').then(\n    (gi) => gi.split(/\\r?\\n/).some((l) => l.trim() === 'local/'),\n    () => false,\n  );\n  if (giOk) add('ignore-local', 'pass', 'Machine-local state is git-ignored');\n  else if (o.fix && projectOk) {\n    await atomicWriteFile(ws.gitignore, LOCAL_GITIGNORE);\n    fixed.push('wrote .devworkspace/.gitignore');\n    add('ignore-local', 'pass', 'Wrote .devworkspace/.gitignore');\n  } else add('ignore-local', 'fail', '.devworkspace/.gitignore does not ignore local/', 'Run: devworkspace doctor --fix');\n\n  try {\n    const rootGi = await fs.readFile(path.join(root, '.gitignore'), 'utf8');\n    if (rootGi.split(/\\r?\\n/).some((l) => /^\\/?\\.devworkspace\\/?\\*?$/.test(l.trim()))) {\n      add('ignore-root', 'warn', 'The root .gitignore ignores all of .devworkspace/, so project knowledge will not be shared', 'Remove that rule; .devworkspace/.gitignore already excludes machine-local files.');\n    }\n  } catch {\n    /* no root .gitignore */\n  }\n\n  // Knowledge and contract.\n  try {\n    const facts = await loadFacts(ws);\n    const stale = facts.facts.filter((f) => f.status === 'STALE');\n    add('facts', 'pass', `${facts.facts.length} fact(s) stored`);\n    if (stale.length > 0) add('staleness', 'warn', `${stale.length} stale fact(s): ${stale.slice(0, 5).map((f) => f.key).join(', ')}`, 'Run: devworkspace refresh');\n    else if (facts.facts.length > 0) add('staleness', 'pass', 'No stale facts recorded');\n  } catch (e) {\n    add('facts', 'fail', (e as Error).message.split('\\n')[0]!, 'Restore .devworkspace/context/facts.json from Git or a backup under .devworkspace/local/backups.');\n  }\n\n  if (await pathExists(ws.commands)) {\n    try {\n      const c = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data;\n      add('contract', 'pass', 'Testing contract present');\n      const unit = c.checks.find((x) => x.id === 'unit');\n      if (!unit?.available) add('tests-available', 'warn', 'No unit-test command detected', 'Add a test script or edit .devworkspace/context/commands.json; tasks will not be able to demand tests.');\n      if (!c.checks.some((x) => x.id === 'build' && x.available)) add('build-available', 'info', 'No build command detected');\n    } catch (e) {\n      add('contract', 'fail', (e as Error).message.split('\\n')[0]!, 'Fix commands.json or re-run: devworkspace analyze');\n    }\n  } else add('contract', 'warn', 'Testing contract not generated yet', 'Run: devworkspace analyze');\n\n  if (await pathExists(ws.analysisState)) {\n    try {\n      const a = (await readVersioned(ws.analysisState, 'analysis', SCHEMA_VERSION, validateAnalysisState)).data;\n      add('analysis', 'pass', `Last analysis ${a.analyzedAt}${a.truncated ? ' (partial: size limits hit)' : ''}`);\n    } catch (e) {\n      add('analysis', 'fail', (e as Error).message.split('\\n')[0]!, 'Re-run: devworkspace analyze');\n    }\n  } else add('analysis', 'warn', 'Repository has not been analyzed', 'Run: devworkspace analyze');\n\n  // Prompt quality (when present).\n  if (await pathExists(ws.onboardingPrompt)) {\n    const text = (await readTextBounded(ws.onboardingPrompt, 1024 * 1024)) ?? '';\n    const missing = validatePrompt(text, ONBOARDING_REQUIREMENTS);\n    if (missing.length === 0) add('onboarding-prompt', 'pass', 'Onboarding prompt satisfies all behavioural requirements');\n    else add('onboarding-prompt', 'fail', `Onboarding prompt is missing: ${missing.join(', ')}`, 'Re-run: devworkspace analyze');\n  }\n\n  // Agent wiring.\n  if (await instructionsInstalled(ws)) add('agent-instructions', 'pass', 'Claude instructions and skill installed');\n  else add('agent-instructions', 'warn', 'Claude instructions are not installed (or the managed section is missing)', 'Run: devworkspace agent install');\n  if (await knowledgeWritten(ws)) add('onboarding', 'pass', 'Architecture knowledge written');\n  else add('onboarding', 'warn', 'Onboarding is not complete: .devworkspace/context/architecture.md is missing or empty', 'Paste .devworkspace/analysis/onboarding-prompt.md into Claude Code.');\n\n  // Integrations.\n  for (const i of await detectIntegrations(integrationCtx(o, root))) {\n    if (i.state === 'READY') add(`integration-${i.id}`, 'pass', `${i.name}: ready`);\n    else if (i.optional) add(`integration-${i.id}`, 'info', `${i.name}: ${i.state.toLowerCase().replace('_', ' ')} (optional)`);\n    else add(`integration-${i.id}`, 'warn', `${i.name}: ${i.state.toLowerCase().replace('_', ' ')}${i.details[0] ? ` - ${i.details[0]}` : ''}`, i.remediation[0]);\n  }\n\n  // Security and portability.\n  const wsFiles = (await listFilesRecursive(ws.dir, 3000)).filter((f) => !f.startsWith(ws.localDir) && !/\\.tmp$/.test(f));\n  const secretHits: string[] = [];\n  const absHits: string[] = [];\n  for (const f of wsFiles) {\n    if (!/\\.(json|md)$/.test(f)) continue;\n    const rel = path.relative(ws.dir, f).replace(/\\\\/g, '/');\n    const text = await readTextBounded(f, 1024 * 1024);\n    if (!text) continue;\n    if (findSecrets(text).length > 0) secretHits.push(rel);\n    if (rel !== 'analysis/onboarding-prompt.md' && rel !== 'analysis/refresh-prompt.md' && findAbsolutePaths(text).length > 0) absHits.push(rel);\n  }\n  if (secretHits.length === 0) add('secrets', 'pass', 'No secret-like values in .devworkspace');\n  else add('secrets', 'fail', `Secret-like values found in: ${secretHits.join(', ')}`, 'Remove the values, rotate the credential if it was real, and re-run doctor.');\n  if (absHits.length === 0) add('portability', 'pass', 'No machine-specific absolute paths in portable knowledge');\n  else add('portability', 'warn', `Absolute paths found in: ${absHits.join(', ')}`, 'Replace them with project-relative paths so the workspace works after the project moves.');\n\n  const git = await getGitState(root);\n  if (git.isRepo) {\n    const tracked = await gitTrackedFiles(root);\n    const bad = (tracked ?? []).filter((f) => isSensitiveFile(f));\n    if (bad.length > 0) add('tracked-secrets', 'warn', `Credential-like files are tracked by Git: ${bad.slice(0, 5).join(', ')}`, 'Remove them from Git history if they hold real secrets (git rm --cached, then rotate).');\n    else add('tracked-secrets', 'pass', 'No credential-like files tracked by Git');\n  }\n\n  const leftovers = wsFiles.filter((f) => f.endsWith('.tmp'));\n  const allTmp = (await listFilesRecursive(ws.dir, 3000)).filter((f) => f.endsWith('.tmp'));\n  if (allTmp.length > 0 || leftovers.length > 0) add('tmp-files', 'warn', `${allTmp.length} leftover temporary file(s) from an interrupted write`, 'They are safe to delete: ' + allTmp.slice(0, 3).map((f) => path.relative(root, f).replace(/\\\\/g, '/')).join(', '));\n\n  // Tasks and decisions.\n  const { tasks, corrupt } = await listTasks(ws, { includeCompleted: true });\n  if (corrupt.length > 0) add('tasks', 'fail', `${corrupt.length} unreadable task file(s): ${corrupt.map((c) => c.file).join(', ')}`, 'Restore them from Git or delete the broken file.');\n  else add('tasks', 'pass', `${tasks.length} task(s) readable`);\n  const dec = await listDecisions(ws);\n  if (dec.unreadable.length > 0) add('decisions', 'warn', `Unreadable decision file(s): ${dec.unreadable.join(', ')}`, 'Check their front matter.');\n\n  return finish(root, checks, fixed, ws);\n}\n\nasync function finish(root: string | null, checks: DoctorCheck[], fixed: string[], ws?: Ws): Promise<DoctorResult> {\n  const counts = { pass: 0, warn: 0, fail: 0, info: 0 };\n  for (const c of checks) counts[c.status]++;\n  let ready = false;\n  if (ws) ready = counts.fail === 0 && (await instructionsInstalled(ws)) && (await knowledgeWritten(ws));\n  return { root, checks, counts, healthy: counts.fail === 0, ready, fixed };\n}\n"]}

package/dist/services/init.d.ts

@@ -0,0 +1,18 @@
+import { detectIntegrations } from '../integrations/index.js';
+import { type ServiceOptions } from './common.js';
+export interface InitOptions extends ServiceOptions {
+    /** Explicit project root; defaults to the Git top-level or the current directory. */
+    root?: string;
+}
+export interface InitResult {
+    root: string;
+    dryRun: boolean;
+    alreadyInitialized: boolean;
+    created: string[];
+    unchanged: string[];
+    gitignoreUpdated: boolean;
+    notes: string[];
+    integrations: Awaited<ReturnType<typeof detectIntegrations>>;
+    nextSteps: string[];
+}
+export declare function initWorkspace(o: InitOptions): Promise<InitResult>;