devworkspace 0.2.2 → 0.3.0

package/dist/discovery/cache.js

@@ -0,0 +1,50 @@
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { isRecord } from '../config/validate.js';
+import { packageVersion } from '../core/version.js';
+import { atomicWriteJson, ensureDir, pathExists, readJsonFile, sha256File, sha256Text } from '../utils/fs.js';
+/** Bump when the cache layout or the key's inputs change; older entries then miss. */
+const CACHE_FORMAT = 1;
+/** Files whose content detectProject reads. Any other file only matters through the scan (its path), which is hashed too. */
+export const READ_BY_DETECT = /(?:^|\/)(?:package\.json|pnpm-workspace\.yaml|Cargo\.toml|pyproject\.toml|Pipfile|setup\.py|setup\.cfg|requirements[^/]*\.txt)$/;
+/** Project-local and git-ignored (under .devworkspace/local); never part of portable knowledge. */
+export const cacheFile = (ws) => path.join(ws.localDir, 'cache', 'discovery.json');
+/**
+ * Hash of everything detectProject depends on: the scan result, the content of every file it reads, the project name,
+ * the CLI version (detection logic) and the scan limit. Content-based: touching a file without changing it still hits.
+ */
+export async function discoveryKey(root, projectName, scan, maxFiles) {
+    const h = createHash('sha256');
+    h.update(JSON.stringify([CACHE_FORMAT, packageVersion(), projectName, maxFiles ?? null, scan.fileCount, scan.dirCount, scan.truncated, scan.skippedSymlinks, scan.ignoredEntries, scan.byExtension, scan.topDirs, scan.sensitiveFiles]));
+    h.update([...scan.files].join('\n'));
+    const read = [...scan.files].filter((f) => READ_BY_DETECT.test(f));
+    const hashes = await Promise.all(read.map((f) => sha256File(path.join(root, ...f.split('/'))).catch(() => 'unreadable')));
+    read.forEach((f, i) => h.update(`\n${f}:${hashes[i]}`));
+    return h.digest('hex');
+}
+/** A cached report is only a shortcut for recomputation with identical inputs; it is never evidence about the repository. */
+export async function readDiscoveryCache(ws, key) {
+    const file = cacheFile(ws);
+    if (!(await pathExists(file)))
+        return { status: 'miss', report: null };
+    try {
+        const c = await readJsonFile(file);
+        if (isRecord(c) && c.key === key && isRecord(c.report) && c.reportHash === sha256Text(JSON.stringify(c.report))) {
+            return { status: 'hit', report: c.report };
+        }
+    }
+    catch {
+        /* unreadable or malformed cache: recompute */
+    }
+    return { status: 'invalidated', report: null };
+}
+export async function writeDiscoveryCache(ws, key, report) {
+    try {
+        await ensureDir(path.dirname(cacheFile(ws)));
+        await atomicWriteJson(cacheFile(ws), { key, reportHash: sha256Text(JSON.stringify(report)), report });
+    }
+    catch {
+        /* the cache is an optimisation; failing to write it must never fail analysis */
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/discovery/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/discovery/cache.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'node:path';\nimport { createHash } from 'node:crypto';\nimport { isRecord } from '../config/validate.js';\nimport type { Ws } from '../core/workspace.js';\nimport { packageVersion } from '../core/version.js';\nimport { atomicWriteJson, ensureDir, pathExists, readJsonFile, sha256File, sha256Text } from '../utils/fs.js';\nimport type { DiscoveryReport } from './detect.js';\nimport type { ScanResult } from './scan.js';\n\nexport type CacheStatus = 'hit' | 'miss' | 'invalidated' | 'off';\n\n/** Bump when the cache layout or the key's inputs change; older entries then miss. */\nconst CACHE_FORMAT = 1;\n\n/** Files whose content detectProject reads. Any other file only matters through the scan (its path), which is hashed too. */\nexport const READ_BY_DETECT = /(?:^|\\/)(?:package\\.json|pnpm-workspace\\.yaml|Cargo\\.toml|pyproject\\.toml|Pipfile|setup\\.py|setup\\.cfg|requirements[^/]*\\.txt)$/;\n\n/** Project-local and git-ignored (under .devworkspace/local); never part of portable knowledge. */\nexport const cacheFile = (ws: Ws): string => path.join(ws.localDir, 'cache', 'discovery.json');\n\n/**\n * Hash of everything detectProject depends on: the scan result, the content of every file it reads, the project name,\n * the CLI version (detection logic) and the scan limit. Content-based: touching a file without changing it still hits.\n */\nexport async function discoveryKey(root: string, projectName: string, scan: ScanResult, maxFiles: number | undefined): Promise<string> {\n  const h = createHash('sha256');\n  h.update(JSON.stringify([CACHE_FORMAT, packageVersion(), projectName, maxFiles ?? null, scan.fileCount, scan.dirCount, scan.truncated, scan.skippedSymlinks, scan.ignoredEntries, scan.byExtension, scan.topDirs, scan.sensitiveFiles]));\n  h.update([...scan.files].join('\\n'));\n  const read = [...scan.files].filter((f) => READ_BY_DETECT.test(f));\n  const hashes = await Promise.all(read.map((f) => sha256File(path.join(root, ...f.split('/'))).catch(() => 'unreadable')));\n  read.forEach((f, i) => h.update(`\\n${f}:${hashes[i]}`));\n  return h.digest('hex');\n}\n\n/** A cached report is only a shortcut for recomputation with identical inputs; it is never evidence about the repository. */\nexport async function readDiscoveryCache(ws: Ws, key: string): Promise<{ status: CacheStatus; report: DiscoveryReport | null }> {\n  const file = cacheFile(ws);\n  if (!(await pathExists(file))) return { status: 'miss', report: null };\n  try {\n    const c = await readJsonFile(file);\n    if (isRecord(c) && c.key === key && isRecord(c.report) && c.reportHash === sha256Text(JSON.stringify(c.report))) {\n      return { status: 'hit', report: c.report as unknown as DiscoveryReport };\n    }\n  } catch {\n    /* unreadable or malformed cache: recompute */\n  }\n  return { status: 'invalidated', report: null };\n}\n\nexport async function writeDiscoveryCache(ws: Ws, key: string, report: DiscoveryReport): Promise<void> {\n  try {\n    await ensureDir(path.dirname(cacheFile(ws)));\n    await atomicWriteJson(cacheFile(ws), { key, reportHash: sha256Text(JSON.stringify(report)), report });\n  } catch {\n    /* the cache is an optimisation; failing to write it must never fail analysis */\n  }\n}\n"]}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export { analyzeWorkspace } from './services/analysis.js';
 export { getStatus } from './services/status.js';
 export { runDoctor } from './services/doctor.js';
 export { refreshWorkspace } from './services/refresh.js';
+export { getTaskContext } from './services/taskContext.js';
 export { getContext, addFact, verifyFactByKey, removeFactByKey } from './services/knowledge.js';
 export { createTask, listTasksService, showTask, setTaskStatus, updateTask, recordVerification, recordTests, attestTask } from './services/tasks.js';
 export { recordDecision, getDecisions, recordSession, getSessions } from './services/records.js';

package/dist/index.js

@@ -6,6 +6,7 @@ export { analyzeWorkspace } from './services/analysis.js';
 export { getStatus } from './services/status.js';
 export { runDoctor } from './services/doctor.js';
 export { refreshWorkspace } from './services/refresh.js';
+export { getTaskContext } from './services/taskContext.js';
 export { getContext, addFact, verifyFactByKey, removeFactByKey } from './services/knowledge.js';
 export { createTask, listTasksService, showTask, setTaskStatus, updateTask, recordVerification, recordTests, attestTask } from './services/tasks.js';
 export { recordDecision, getDecisions, recordSession, getSessions } from './services/records.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACrJ,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["// Programmatic API: the same engine that powers the CLI, for a future VS Code extension, dashboards and automation.\nexport { packageVersion } from './core/version.js';\nexport { DevWorkspaceError, EXIT } from './errors/index.js';\nexport { initWorkspace } from './services/init.js';\nexport { analyzeWorkspace } from './services/analysis.js';\nexport { getStatus } from './services/status.js';\nexport { runDoctor } from './services/doctor.js';\nexport { refreshWorkspace } from './services/refresh.js';\nexport { getContext, addFact, verifyFactByKey, removeFactByKey } from './services/knowledge.js';\nexport { createTask, listTasksService, showTask, setTaskStatus, updateTask, recordVerification, recordTests, attestTask } from './services/tasks.js';\nexport { recordDecision, getDecisions, recordSession, getSessions } from './services/records.js';\nexport { installAgent } from './services/agent.js';\nexport { exportWorkspace, importWorkspace } from './services/portability.js';\nexport { migrateWorkspace } from './services/migrate.js';\nexport { resetWorkspace } from './services/reset.js';\nexport { setupIntegrations, integrationsStatus } from './services/integrations.js';\nexport { classifyRequest, detectConstraints, WORKFLOWS } from './tasks/routing.js';\nexport { evaluateGate } from './tasks/task.js';\nexport { redact, findSecrets, containsSecret } from './security/redact.js';\nexport { isSensitiveFile } from './security/files.js';\nexport { buildOnboardingPrompt } from './prompts/onboarding.js';\nexport { ONBOARDING_REQUIREMENTS, REFRESH_REQUIREMENTS, validatePrompt } from './prompts/requirements.js';\nexport type { ServiceOptions } from './services/common.js';\nexport type { StatusResult } from './services/status.js';\nexport type { DoctorResult, DoctorCheck } from './services/doctor.js';\nexport type { Task, TaskStatus, TaskType } from './tasks/task.js';\nexport type { Fact, ProjectConfig, CommandEntry } from './config/schemas.js';\nexport type { IntegrationReport, StatusCode as IntegrationStatusCode } from './integrations/types.js';\nexport type { AgentAdapter, PlannedChange } from './agents/types.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACrJ,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["// Programmatic API: the same engine that powers the CLI, for a future VS Code extension, dashboards and automation.\nexport { packageVersion } from './core/version.js';\nexport { DevWorkspaceError, EXIT } from './errors/index.js';\nexport { initWorkspace } from './services/init.js';\nexport { analyzeWorkspace } from './services/analysis.js';\nexport { getStatus } from './services/status.js';\nexport { runDoctor } from './services/doctor.js';\nexport { refreshWorkspace } from './services/refresh.js';\nexport { getTaskContext } from './services/taskContext.js';\nexport { getContext, addFact, verifyFactByKey, removeFactByKey } from './services/knowledge.js';\nexport { createTask, listTasksService, showTask, setTaskStatus, updateTask, recordVerification, recordTests, attestTask } from './services/tasks.js';\nexport { recordDecision, getDecisions, recordSession, getSessions } from './services/records.js';\nexport { installAgent } from './services/agent.js';\nexport { exportWorkspace, importWorkspace } from './services/portability.js';\nexport { migrateWorkspace } from './services/migrate.js';\nexport { resetWorkspace } from './services/reset.js';\nexport { setupIntegrations, integrationsStatus } from './services/integrations.js';\nexport { classifyRequest, detectConstraints, WORKFLOWS } from './tasks/routing.js';\nexport { evaluateGate } from './tasks/task.js';\nexport { redact, findSecrets, containsSecret } from './security/redact.js';\nexport { isSensitiveFile } from './security/files.js';\nexport { buildOnboardingPrompt } from './prompts/onboarding.js';\nexport { ONBOARDING_REQUIREMENTS, REFRESH_REQUIREMENTS, validatePrompt } from './prompts/requirements.js';\nexport type { ServiceOptions } from './services/common.js';\nexport type { StatusResult } from './services/status.js';\nexport type { DoctorResult, DoctorCheck } from './services/doctor.js';\nexport type { Task, TaskStatus, TaskType } from './tasks/task.js';\nexport type { Fact, ProjectConfig, CommandEntry } from './config/schemas.js';\nexport type { IntegrationReport, StatusCode as IntegrationStatusCode } from './integrations/types.js';\nexport type { AgentAdapter, PlannedChange } from './agents/types.js';\n"]}

package/dist/integrations/adapters/claudePlugin.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { promises as fs } from 'node:fs';
+import { promises as fs, realpathSync } from 'node:fs';
 import { compareVersions, parseLastJsonLine } from '../exec.js';
 import { isInside } from '../../utils/paths.js';
 /** Minimum Claude Code versions for the flags we rely on (from the plugin CLI reference). */
@@ -24,17 +24,26 @@ export async function marketplaceRegistered(ctx, claude, name) {
         return null;
     return new RegExp(`(^|[^A-Za-z0-9._-])${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}($|[^A-Za-z0-9._-])`, 'm').test(r.stdout);
 }
+/** Resolve symlinks when the path exists (macOS temp dirs live under /var, a link to /private/var), else just normalise. */
+function canonical(p) {
+    try {
+        return realpathSync(path.resolve(p));
+    }
+    catch {
+        return path.resolve(p);
+    }
+}
 export function samePath(a, b) {
     if (!a)
         return false;
-    const norm = (p) => path.resolve(p).replace(/[\\/]+$/, '');
+    const norm = (p) => canonical(p).replace(/[\\/]+$/, '');
     const x = norm(a);
     const y = norm(b);
     return process.platform === 'win32' ? x.toLowerCase() === y.toLowerCase() : x === y;
 }
 /** Match the plugin for this project: user-scope installs apply everywhere; project/local installs must belong to this root. */
 export function findPlugin(plugins, id, root) {
-    return plugins.find((p) => p.id === id && (p.scope === 'user' || p.scope === 'managed' || samePath(p.projectPath, root) || (p.projectPath && isInside(root, p.projectPath))));
+    return plugins.find((p) => p.id === id && (p.scope === 'user' || p.scope === 'managed' || samePath(p.projectPath, root) || (p.projectPath && isInside(canonical(root), canonical(p.projectPath)))));
 }
 /** Cheap check of settings files (no process spawn): which plugins/marketplaces are declared. */
 export async function readDeclared(ctx, spec) {

package/dist/integrations/adapters/claudePlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"claudePlugin.js","sourceRoot":"","sources":["../../../src/integrations/adapters/claudePlugin.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'node:path';\nimport { promises as fs } from 'node:fs';\nimport { compareVersions, parseLastJsonLine, type Tool } from '../exec.js';\nimport { isInside } from '../../utils/paths.js';\nimport type { AdapterContext, InstallScope, PlanStep, StepOutcome } from '../types.js';\n\n/** Minimum Claude Code versions for the flags we rely on (from the plugin CLI reference). */\nexport const MIN_PLUGIN_JSON = '2.1.268';\nexport const MIN_MARKETPLACE_JSON = '2.1.287';\n\nexport interface InstalledPlugin {\n  id: string;\n  version?: string;\n  scope: string;\n  enabled: boolean;\n  projectPath?: string;\n  errors?: string[];\n}\n\nexport interface NativeSpec {\n  marketplaceName: string;\n  /** Always an https git URL: `owner/repo` shorthand makes Claude Code try SSH, which fails without GitHub keys. */\n  marketplaceUrl: string;\n  pluginName: string;\n}\n\nexport const pluginId = (s: NativeSpec): string => `${s.pluginName}@${s.marketplaceName}`;\n\nexport async function listPlugins(ctx: AdapterContext, claude: Tool): Promise<{ ok: boolean; plugins: InstalledPlugin[]; error?: string }> {\n  const r = await ctx.runner.run({ command: claude.command, args: ['plugin', 'list', '--json'], cwd: ctx.root, timeoutMs: 30_000, signal: ctx.signal });\n  if (!r.ok) return { ok: false, plugins: [], error: (r.stderr || r.error || r.stdout).trim().slice(0, 300) || `exit ${r.code}` };\n  try {\n    const parsed = JSON.parse(r.stdout.trim().split(/\\r?\\n/).filter((l) => l.trim().startsWith('[')).pop() ?? r.stdout) as unknown;\n    return { ok: true, plugins: Array.isArray(parsed) ? (parsed as InstalledPlugin[]) : [] };\n  } catch {\n    return { ok: false, plugins: [], error: 'could not parse `claude plugin list --json` output' };\n  }\n}\n\nexport async function marketplaceRegistered(ctx: AdapterContext, claude: Tool, name: string): Promise<boolean | null> {\n  const r = await ctx.runner.run({ command: claude.command, args: ['plugin', 'marketplace', 'list'], cwd: ctx.root, timeoutMs: 30_000, signal: ctx.signal });\n  if (!r.ok) return null;\n  return new RegExp(`(^|[^A-Za-z0-9._-])${name.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}($|[^A-Za-z0-9._-])`, 'm').test(r.stdout);\n}\n\nexport function samePath(a: string | undefined, b: string): boolean {\n  if (!a) return false;\n  const norm = (p: string): string => path.resolve(p).replace(/[\\\\/]+$/, '');\n  const x = norm(a);\n  const y = norm(b);\n  return process.platform === 'win32' ? x.toLowerCase() === y.toLowerCase() : x === y;\n}\n\n/** Match the plugin for this project: user-scope installs apply everywhere; project/local installs must belong to this root. */\nexport function findPlugin(plugins: InstalledPlugin[], id: string, root: string): InstalledPlugin | undefined {\n  return plugins.find((p) => p.id === id && (p.scope === 'user' || p.scope === 'managed' || samePath(p.projectPath, root) || (p.projectPath && isInside(root, p.projectPath))));\n}\n\n/** Cheap check of settings files (no process spawn): which plugins/marketplaces are declared. */\nexport async function readDeclared(ctx: AdapterContext, spec: NativeSpec): Promise<{ marketplace: boolean; enabled: InstallScope | null }> {\n  const files: [string, InstallScope][] = [\n    [path.join(ctx.root, '.claude', 'settings.json'), 'project'],\n    [path.join(ctx.root, '.claude', 'settings.local.json'), 'project'],\n    [path.join(ctx.home, '.claude', 'settings.json'), 'user'],\n  ];\n  let marketplace = false;\n  let enabled: InstallScope | null = null;\n  for (const [file, scope] of files) {\n    try {\n      const j = JSON.parse(await fs.readFile(file, 'utf8')) as { extraKnownMarketplaces?: Record<string, unknown>; enabledPlugins?: Record<string, unknown> };\n      if (j.extraKnownMarketplaces && spec.marketplaceName in j.extraKnownMarketplaces) marketplace = true;\n      if (j.enabledPlugins && j.enabledPlugins[pluginId(spec)] === true && enabled === null) enabled = scope;\n    } catch {\n      /* missing or unreadable */\n    }\n  }\n  return { marketplace, enabled };\n}\n\nexport const SSH_FIX = 'git config --global url.\"https://github.com/\".insteadOf git@github.com:';\n\n/** Claude Code clones plugin sources over SSH by default; without a GitHub SSH key that fails with these messages. */\nexport function sshHint(text: string): string | undefined {\n  return /host key verification failed|permission denied \\(publickey\\)|could not read from remote repository/i.test(text)\n    ? `Claude Code cloned over SSH and you have no usable GitHub SSH key. The fix documented by Agent Skills changes your global Git config, so run it yourself, then re-run setup: ${SSH_FIX}`\n    : undefined;\n}\n\nfunction describeFailure(json: Record<string, unknown> | null, stderr: string, stdout: string): string {\n  const msg = typeof json?.message === 'string' ? json.message : (stderr || stdout).trim().split(/\\r?\\n/).filter(Boolean).slice(-2).join(' ');\n  return msg.slice(0, 400) || 'the command failed without output';\n}\n\n/** Steps that register the marketplace (if needed) and install the plugin at the given scope. */\nexport function nativeSteps(ctx: AdapterContext, claude: Tool, spec: NativeSpec, scope: InstallScope, opts: { registered: boolean }): PlanStep[] {\n  const steps: PlanStep[] = [];\n  const level = scope === 'user' ? 'user-config' : 'project';\n  const useMpJson = compareVersions(claude.version, MIN_MARKETPLACE_JSON) >= 0;\n  const useJson = compareVersions(claude.version, MIN_PLUGIN_JSON) >= 0;\n  const exe = path.basename(claude.command, path.extname(claude.command));\n\n  if (!opts.registered) {\n    const args = ['plugin', 'marketplace', 'add', spec.marketplaceUrl, '--scope', scope, ...(useMpJson ? ['--json'] : [])];\n    steps.push({\n      id: `${spec.marketplaceName}:marketplace`,\n      description: `Register the ${spec.marketplaceName} marketplace (${scope} scope)`,\n      command: `${exe} ${args.join(' ')}`,\n      level,\n      async run(): Promise<StepOutcome> {\n        const r = await ctx.runner.run({ command: claude.command, args, cwd: ctx.root, timeoutMs: 180_000, signal: ctx.signal });\n        const json = parseLastJsonLine(r.stdout);\n        if (r.aborted) return { ok: false, detail: 'cancelled' };\n        if (r.timedOut) return { ok: false, detail: 'timed out after 180 s (network?)' };\n        if (r.ok && json?.outcome !== 'failed') return { ok: true, detail: typeof json?.message === 'string' ? json.message : 'registered' };\n        if (/already (on disk|added|exists)/i.test(r.stdout + r.stderr)) return { ok: true, detail: 'already registered' };\n        return { ok: false, detail: describeFailure(json, r.stderr, r.stdout), hint: sshHint(`${r.stdout}\\n${r.stderr}`) };\n      },\n    });\n  }\n\n  const installArgs = ['plugin', 'install', pluginId(spec), '--scope', scope, ...(useJson ? ['--json'] : [])];\n  steps.push({\n    id: `${pluginId(spec)}:install`,\n    description: `Install the ${spec.pluginName} plugin (${scope} scope)`,\n    command: `${exe} ${installArgs.join(' ')}`,\n    level,\n    async run(): Promise<StepOutcome> {\n      // Never pass -y: that would accept a marketplace-declared command without the user seeing it.\n      const r = await ctx.runner.run({ command: claude.command, args: installArgs, cwd: ctx.root, timeoutMs: 180_000, signal: ctx.signal });\n      const json = parseLastJsonLine(r.stdout);\n      if (r.aborted) return { ok: false, detail: 'cancelled' };\n      if (r.timedOut) return { ok: false, detail: 'timed out after 180 s (network?)' };\n      const text = `${r.stdout}\\n${r.stderr}`;\n      if (json && (json.shownCommand || json.failureCode === 'command_not_accepted') || /only displayed|Run this command now/i.test(text)) {\n        return { ok: false, requiresApproval: true, detail: 'Claude Code needs you to approve a command shown by the marketplace; run the command above yourself in a terminal.' };\n      }\n      if (/already installed/i.test(text) && r.ok) return { ok: true, detail: 'already installed' };\n      if (r.ok && json?.outcome !== 'failed') return { ok: true, detail: 'installed', restartRequired: true };\n      return { ok: false, detail: describeFailure(json, r.stderr, r.stdout), hint: sshHint(`${r.stdout}\\n${r.stderr}`) };\n    },\n  });\n  return steps;\n}\n"]}
+{"version":3,"file":"claudePlugin.js","sourceRoot":"","sources":["../../../src/integrations/adapters/claudePlugin.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'node:path';\nimport { promises as fs, realpathSync } from 'node:fs';\nimport { compareVersions, parseLastJsonLine, type Tool } from '../exec.js';\nimport { isInside } from '../../utils/paths.js';\nimport type { AdapterContext, InstallScope, PlanStep, StepOutcome } from '../types.js';\n\n/** Minimum Claude Code versions for the flags we rely on (from the plugin CLI reference). */\nexport const MIN_PLUGIN_JSON = '2.1.268';\nexport const MIN_MARKETPLACE_JSON = '2.1.287';\n\nexport interface InstalledPlugin {\n  id: string;\n  version?: string;\n  scope: string;\n  enabled: boolean;\n  projectPath?: string;\n  errors?: string[];\n}\n\nexport interface NativeSpec {\n  marketplaceName: string;\n  /** Always an https git URL: `owner/repo` shorthand makes Claude Code try SSH, which fails without GitHub keys. */\n  marketplaceUrl: string;\n  pluginName: string;\n}\n\nexport const pluginId = (s: NativeSpec): string => `${s.pluginName}@${s.marketplaceName}`;\n\nexport async function listPlugins(ctx: AdapterContext, claude: Tool): Promise<{ ok: boolean; plugins: InstalledPlugin[]; error?: string }> {\n  const r = await ctx.runner.run({ command: claude.command, args: ['plugin', 'list', '--json'], cwd: ctx.root, timeoutMs: 30_000, signal: ctx.signal });\n  if (!r.ok) return { ok: false, plugins: [], error: (r.stderr || r.error || r.stdout).trim().slice(0, 300) || `exit ${r.code}` };\n  try {\n    const parsed = JSON.parse(r.stdout.trim().split(/\\r?\\n/).filter((l) => l.trim().startsWith('[')).pop() ?? r.stdout) as unknown;\n    return { ok: true, plugins: Array.isArray(parsed) ? (parsed as InstalledPlugin[]) : [] };\n  } catch {\n    return { ok: false, plugins: [], error: 'could not parse `claude plugin list --json` output' };\n  }\n}\n\nexport async function marketplaceRegistered(ctx: AdapterContext, claude: Tool, name: string): Promise<boolean | null> {\n  const r = await ctx.runner.run({ command: claude.command, args: ['plugin', 'marketplace', 'list'], cwd: ctx.root, timeoutMs: 30_000, signal: ctx.signal });\n  if (!r.ok) return null;\n  return new RegExp(`(^|[^A-Za-z0-9._-])${name.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}($|[^A-Za-z0-9._-])`, 'm').test(r.stdout);\n}\n\n/** Resolve symlinks when the path exists (macOS temp dirs live under /var, a link to /private/var), else just normalise. */\nfunction canonical(p: string): string {\n  try {\n    return realpathSync(path.resolve(p));\n  } catch {\n    return path.resolve(p);\n  }\n}\n\nexport function samePath(a: string | undefined, b: string): boolean {\n  if (!a) return false;\n  const norm = (p: string): string => canonical(p).replace(/[\\\\/]+$/, '');\n  const x = norm(a);\n  const y = norm(b);\n  return process.platform === 'win32' ? x.toLowerCase() === y.toLowerCase() : x === y;\n}\n\n/** Match the plugin for this project: user-scope installs apply everywhere; project/local installs must belong to this root. */\nexport function findPlugin(plugins: InstalledPlugin[], id: string, root: string): InstalledPlugin | undefined {\n  return plugins.find((p) => p.id === id && (p.scope === 'user' || p.scope === 'managed' || samePath(p.projectPath, root) || (p.projectPath && isInside(canonical(root), canonical(p.projectPath)))));\n}\n\n/** Cheap check of settings files (no process spawn): which plugins/marketplaces are declared. */\nexport async function readDeclared(ctx: AdapterContext, spec: NativeSpec): Promise<{ marketplace: boolean; enabled: InstallScope | null }> {\n  const files: [string, InstallScope][] = [\n    [path.join(ctx.root, '.claude', 'settings.json'), 'project'],\n    [path.join(ctx.root, '.claude', 'settings.local.json'), 'project'],\n    [path.join(ctx.home, '.claude', 'settings.json'), 'user'],\n  ];\n  let marketplace = false;\n  let enabled: InstallScope | null = null;\n  for (const [file, scope] of files) {\n    try {\n      const j = JSON.parse(await fs.readFile(file, 'utf8')) as { extraKnownMarketplaces?: Record<string, unknown>; enabledPlugins?: Record<string, unknown> };\n      if (j.extraKnownMarketplaces && spec.marketplaceName in j.extraKnownMarketplaces) marketplace = true;\n      if (j.enabledPlugins && j.enabledPlugins[pluginId(spec)] === true && enabled === null) enabled = scope;\n    } catch {\n      /* missing or unreadable */\n    }\n  }\n  return { marketplace, enabled };\n}\n\nexport const SSH_FIX = 'git config --global url.\"https://github.com/\".insteadOf git@github.com:';\n\n/** Claude Code clones plugin sources over SSH by default; without a GitHub SSH key that fails with these messages. */\nexport function sshHint(text: string): string | undefined {\n  return /host key verification failed|permission denied \\(publickey\\)|could not read from remote repository/i.test(text)\n    ? `Claude Code cloned over SSH and you have no usable GitHub SSH key. The fix documented by Agent Skills changes your global Git config, so run it yourself, then re-run setup: ${SSH_FIX}`\n    : undefined;\n}\n\nfunction describeFailure(json: Record<string, unknown> | null, stderr: string, stdout: string): string {\n  const msg = typeof json?.message === 'string' ? json.message : (stderr || stdout).trim().split(/\\r?\\n/).filter(Boolean).slice(-2).join(' ');\n  return msg.slice(0, 400) || 'the command failed without output';\n}\n\n/** Steps that register the marketplace (if needed) and install the plugin at the given scope. */\nexport function nativeSteps(ctx: AdapterContext, claude: Tool, spec: NativeSpec, scope: InstallScope, opts: { registered: boolean }): PlanStep[] {\n  const steps: PlanStep[] = [];\n  const level = scope === 'user' ? 'user-config' : 'project';\n  const useMpJson = compareVersions(claude.version, MIN_MARKETPLACE_JSON) >= 0;\n  const useJson = compareVersions(claude.version, MIN_PLUGIN_JSON) >= 0;\n  const exe = path.basename(claude.command, path.extname(claude.command));\n\n  if (!opts.registered) {\n    const args = ['plugin', 'marketplace', 'add', spec.marketplaceUrl, '--scope', scope, ...(useMpJson ? ['--json'] : [])];\n    steps.push({\n      id: `${spec.marketplaceName}:marketplace`,\n      description: `Register the ${spec.marketplaceName} marketplace (${scope} scope)`,\n      command: `${exe} ${args.join(' ')}`,\n      level,\n      async run(): Promise<StepOutcome> {\n        const r = await ctx.runner.run({ command: claude.command, args, cwd: ctx.root, timeoutMs: 180_000, signal: ctx.signal });\n        const json = parseLastJsonLine(r.stdout);\n        if (r.aborted) return { ok: false, detail: 'cancelled' };\n        if (r.timedOut) return { ok: false, detail: 'timed out after 180 s (network?)' };\n        if (r.ok && json?.outcome !== 'failed') return { ok: true, detail: typeof json?.message === 'string' ? json.message : 'registered' };\n        if (/already (on disk|added|exists)/i.test(r.stdout + r.stderr)) return { ok: true, detail: 'already registered' };\n        return { ok: false, detail: describeFailure(json, r.stderr, r.stdout), hint: sshHint(`${r.stdout}\\n${r.stderr}`) };\n      },\n    });\n  }\n\n  const installArgs = ['plugin', 'install', pluginId(spec), '--scope', scope, ...(useJson ? ['--json'] : [])];\n  steps.push({\n    id: `${pluginId(spec)}:install`,\n    description: `Install the ${spec.pluginName} plugin (${scope} scope)`,\n    command: `${exe} ${installArgs.join(' ')}`,\n    level,\n    async run(): Promise<StepOutcome> {\n      // Never pass -y: that would accept a marketplace-declared command without the user seeing it.\n      const r = await ctx.runner.run({ command: claude.command, args: installArgs, cwd: ctx.root, timeoutMs: 180_000, signal: ctx.signal });\n      const json = parseLastJsonLine(r.stdout);\n      if (r.aborted) return { ok: false, detail: 'cancelled' };\n      if (r.timedOut) return { ok: false, detail: 'timed out after 180 s (network?)' };\n      const text = `${r.stdout}\\n${r.stderr}`;\n      if (json && (json.shownCommand || json.failureCode === 'command_not_accepted') || /only displayed|Run this command now/i.test(text)) {\n        return { ok: false, requiresApproval: true, detail: 'Claude Code needs you to approve a command shown by the marketplace; run the command above yourself in a terminal.' };\n      }\n      if (/already installed/i.test(text) && r.ok) return { ok: true, detail: 'already installed' };\n      if (r.ok && json?.outcome !== 'failed') return { ok: true, detail: 'installed', restartRequired: true };\n      return { ok: false, detail: describeFailure(json, r.stderr, r.stdout), hint: sshHint(`${r.stdout}\\n${r.stderr}`) };\n    },\n  });\n  return steps;\n}\n"]}

package/dist/services/analysis.d.ts

@@ -1,5 +1,6 @@
 import { type CommandEntry } from '../config/schemas.js';
 import { type DiscoveryReport } from '../discovery/detect.js';
+import { type CacheStatus } from '../discovery/cache.js';
 import { type IntegrationReport } from '../integrations/index.js';
 import { type FactInput } from '../knowledge/facts.js';
 import type { Ws } from '../core/workspace.js';
@@ -13,8 +14,13 @@ export interface DiscoveryRun {
         dirty: boolean;
         changedFiles: number;
     };
+    /** Whether detection was reused from the project-local cache (same scan and manifest content) or recomputed. */
+    cache: CacheStatus;
 }
-export declare function runDiscovery(ws: Ws, projectName: string, maxFiles?: number): Promise<DiscoveryRun>;
+/** The scan and the Git query are independent, so they run concurrently. Read-only runs (dry-run) never write the cache. */
+export declare function runDiscovery(ws: Ws, projectName: string, maxFiles?: number, opts?: {
+    writeCache?: boolean;
+}): Promise<DiscoveryRun>;
 /** Facts derived purely from deterministic detection. They are re-derived on every analyze/refresh. */
 export declare function detectorFacts(d: DiscoveryReport): FactInput[];
 export declare function applyDetectorFacts(ws: Ws, d: DiscoveryReport, now: string): Promise<{

package/dist/services/analysis.js

@@ -4,6 +4,7 @@ import { SCHEMA_VERSION, validateCommands } from '../config/schemas.js';
 import { TRUST_NOTE, mergeContract } from '../discovery/commands.js';
 import { detectProject } from '../discovery/detect.js';
 import { scanProject } from '../discovery/scan.js';
+import { discoveryKey, readDiscoveryCache, writeDiscoveryCache } from '../discovery/cache.js';
 import { getGitState } from '../git/git.js';
 import { inspectAll } from '../integrations/index.js';
 import { buildFact, loadFacts, saveFacts, upsertFact } from '../knowledge/facts.js';
@@ -15,13 +16,19 @@ import { isSensitiveFile } from '../security/files.js';
 import { buildOnboardingPrompt } from '../prompts/onboarding.js';
 import { claudeAdapter } from '../agents/claude/adapter.js';
 import { isoNow, managerEnv } 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)]);
+/** The scan and the Git query are independent, so they run concurrently. Read-only runs (dry-run) never write the cache. */
+export async function runDiscovery(ws, projectName, maxFiles, opts = {}) {
+    const [scan, git] = await Promise.all([scanProject(ws.root, maxFiles ? { maxFiles } : {}), getGitState(ws.root)]);
+    const key = await discoveryKey(ws.root, projectName, scan, maxFiles);
+    const cached = await readDiscoveryCache(ws, key);
+    const discovery = cached.report ?? (await detectProject({ root: ws.root, projectName, scan }));
+    if (!cached.report && opts.writeCache)
+        await writeDiscoveryCache(ws, key, discovery);
     return {
         discovery,
         gitHead: git.head,
         git: { isRepo: git.isRepo, branch: git.branch, dirty: git.dirty, changedFiles: git.entries.length },
+        cache: cached.status,
     };
 }
 function existingFiles(files, max = 10) {
@@ -112,7 +119,7 @@ export async function writeCommands(ws, detected, opts = {}) {
 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 run = await runDiscovery(ws, project.name, project.settings.maxFiles, { writeCache: !o.dryRun });
     const integrations = await inspectAll(ws, managerEnv(o, ws.root), { deep: false });
     const existingAgentFiles = await claudeAdapter.detectExisting(ws.root);
     const prompt = buildOnboardingPrompt({

package/dist/services/analysis.js.map

@@ -1 +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, mergeContract } 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 { inspectAll, type IntegrationReport } 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 } 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 { isoNow, managerEnv, 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  if (d.ecosystems.length > 0) {\n    add('stack.ecosystems', d.ecosystems.join(', '), 'repository manifests', d.manifests.slice(0, 20));\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.packages.length > 0) {\n    add('repo.packages', d.monorepo.packages.slice(0, 40).map((p) => `${p.path} (${p.ecosystem}${p.packageManager ? `, ${p.packageManager}` : ''})`).join(', '), 'package manifests', d.manifests.slice(0, 20));\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.entryPoints ?? []).length > 0) {\n    const eps = d.entryPoints.slice(0, 30);\n    add('repo.entry-points', eps.map((e) => `${e.cwd === '.' ? '' : `${e.cwd}/`}${e.path} (${e.kind})`).join(', '), 'package scripts, main and bin', eps.map((e) => (e.cwd === '.' ? e.path : `${e.cwd}/${e.path}`)).slice(0, 10));\n  }\n  if (d.docs.length > 0) add('repo.docs', d.docs.slice(0, 20).join(', '), 'documentation files', existingFiles(d.docs, 20));\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 interface ContractWrite {\n  preservedUser: number;\n  preservedStale: number;\n  incomplete: boolean;\n}\n\n/**\n * Write the testing contract. Commands a person confirmed (origin \"user\") are never dropped, even when this analysis\n * finds nothing; see mergeContract for the exact rules.\n */\nexport async function writeCommands(ws: Ws, detected: CommandEntry[], opts: { truncated?: boolean } = {}): Promise<ContractWrite> {\n  let previous: CommandsFile | null = null;\n  if (await pathExists(ws.commands)) {\n    previous = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data;\n  }\n  const merged = mergeContract(previous?.checks ?? null, detected, opts);\n  const file: CommandsFile = { schemaVersion: SCHEMA_VERSION, trustNote: TRUST_NOTE, checks: merged.checks };\n  validateCommands(file);\n  await writeVersioned(ws, ws.commands, file);\n  return { preservedUser: merged.preservedUser, preservedStale: merged.preservedStale, incomplete: merged.incomplete };\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  contract: ContractWrite | null;\n  integrations: IntegrationReport[];\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 inspectAll(ws, managerEnv(o, ws.root), { deep: false });\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: [] }, contract: null, integrations, promptBytes: prompt.length, nextSteps };\n  }\n\n  await writeJsonIfChanged(ws.discovery, run.discovery);\n  const contract = await writeCommands(ws, run.discovery.commands, { truncated: run.discovery.scan.truncated });\n  const facts = await applyDetectorFacts(ws, run.discovery, now);\n  await writeTextIfChanged(ws.onboardingPrompt, prompt);\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, contract, integrations, promptBytes: prompt.length, nextSteps };\n}\n\nexport function newProjectId(): string {\n  return randomUUID();\n}\n"]}
+{"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, mergeContract } from '../discovery/commands.js';\nimport { detectProject, type DiscoveryReport } from '../discovery/detect.js';\nimport { scanProject } from '../discovery/scan.js';\nimport { discoveryKey, readDiscoveryCache, writeDiscoveryCache, type CacheStatus } from '../discovery/cache.js';\nimport { getGitState } from '../git/git.js';\nimport { inspectAll, type IntegrationReport } 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 } 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 { isoNow, managerEnv, 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  /** Whether detection was reused from the project-local cache (same scan and manifest content) or recomputed. */\n  cache: CacheStatus;\n}\n\n/** The scan and the Git query are independent, so they run concurrently. Read-only runs (dry-run) never write the cache. */\nexport async function runDiscovery(ws: Ws, projectName: string, maxFiles?: number, opts: { writeCache?: boolean } = {}): Promise<DiscoveryRun> {\n  const [scan, git] = await Promise.all([scanProject(ws.root, maxFiles ? { maxFiles } : {}), getGitState(ws.root)]);\n  const key = await discoveryKey(ws.root, projectName, scan, maxFiles);\n  const cached = await readDiscoveryCache(ws, key);\n  const discovery = cached.report ?? (await detectProject({ root: ws.root, projectName, scan }));\n  if (!cached.report && opts.writeCache) await writeDiscoveryCache(ws, key, discovery);\n  return {\n    discovery,\n    gitHead: git.head,\n    git: { isRepo: git.isRepo, branch: git.branch, dirty: git.dirty, changedFiles: git.entries.length },\n    cache: cached.status,\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  if (d.ecosystems.length > 0) {\n    add('stack.ecosystems', d.ecosystems.join(', '), 'repository manifests', d.manifests.slice(0, 20));\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.packages.length > 0) {\n    add('repo.packages', d.monorepo.packages.slice(0, 40).map((p) => `${p.path} (${p.ecosystem}${p.packageManager ? `, ${p.packageManager}` : ''})`).join(', '), 'package manifests', d.manifests.slice(0, 20));\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.entryPoints ?? []).length > 0) {\n    const eps = d.entryPoints.slice(0, 30);\n    add('repo.entry-points', eps.map((e) => `${e.cwd === '.' ? '' : `${e.cwd}/`}${e.path} (${e.kind})`).join(', '), 'package scripts, main and bin', eps.map((e) => (e.cwd === '.' ? e.path : `${e.cwd}/${e.path}`)).slice(0, 10));\n  }\n  if (d.docs.length > 0) add('repo.docs', d.docs.slice(0, 20).join(', '), 'documentation files', existingFiles(d.docs, 20));\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 interface ContractWrite {\n  preservedUser: number;\n  preservedStale: number;\n  incomplete: boolean;\n}\n\n/**\n * Write the testing contract. Commands a person confirmed (origin \"user\") are never dropped, even when this analysis\n * finds nothing; see mergeContract for the exact rules.\n */\nexport async function writeCommands(ws: Ws, detected: CommandEntry[], opts: { truncated?: boolean } = {}): Promise<ContractWrite> {\n  let previous: CommandsFile | null = null;\n  if (await pathExists(ws.commands)) {\n    previous = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data;\n  }\n  const merged = mergeContract(previous?.checks ?? null, detected, opts);\n  const file: CommandsFile = { schemaVersion: SCHEMA_VERSION, trustNote: TRUST_NOTE, checks: merged.checks };\n  validateCommands(file);\n  await writeVersioned(ws, ws.commands, file);\n  return { preservedUser: merged.preservedUser, preservedStale: merged.preservedStale, incomplete: merged.incomplete };\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  contract: ContractWrite | null;\n  integrations: IntegrationReport[];\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, { writeCache: !o.dryRun });\n  const integrations = await inspectAll(ws, managerEnv(o, ws.root), { deep: false });\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: [] }, contract: null, integrations, promptBytes: prompt.length, nextSteps };\n  }\n\n  await writeJsonIfChanged(ws.discovery, run.discovery);\n  const contract = await writeCommands(ws, run.discovery.commands, { truncated: run.discovery.scan.truncated });\n  const facts = await applyDetectorFacts(ws, run.discovery, now);\n  await writeTextIfChanged(ws.onboardingPrompt, prompt);\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, contract, integrations, promptBytes: prompt.length, nextSteps };\n}\n\nexport function newProjectId(): string {\n  return randomUUID();\n}\n"]}

package/dist/services/refresh.js

@@ -16,7 +16,7 @@ export async function refreshWorkspace(o) {
     return mutate(o, async (ws) => {
         const project = await loadProject(ws);
         const now = isoNow(o);
-        const run = await runDiscovery(ws, project.name, project.settings.maxFiles);
+        const run = await runDiscovery(ws, project.name, project.settings.maxFiles, { writeCache: !o.dryRun });
         let previous = null;
         if (await pathExists(ws.analysisState)) {
             previous = (await readVersioned(ws.analysisState, 'analysis', SCHEMA_VERSION, validateAnalysisState)).data;

package/dist/services/refresh.js.map

@@ -1 +1 @@
-{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../../src/services/refresh.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'node:path';\nimport { SCHEMA_VERSION, validateAnalysisState, type AnalysisState } from '../config/schemas.js';\nimport { loadProject } from '../core/workspace.js';\nimport { readVersioned, writeVersioned } from '../core/versioned.js';\nimport { packageVersion } from '../core/version.js';\nimport { applyStaleness, evaluateStaleness, loadFacts, saveFacts } from '../knowledge/facts.js';\nimport { buildRefreshPrompt } from '../prompts/refresh.js';\nimport { pathExists, sha256Text, writeJsonIfChanged, writeTextIfChanged } from '../utils/fs.js';\nimport { applyDetectorFacts, runDiscovery, writeCommands } from './analysis.js';\nimport { isoNow, mutate, type ServiceOptions } from './common.js';\n\nexport interface RefreshResult {\n  dryRun: boolean;\n  headChanged: boolean;\n  autoRefreshed: string[];\n  retired: string[];\n  stale: { key: string; value: string; reason: string }[];\n  needsReview: { key: string; reason: string }[];\n  prompt: string | null;\n}\n\n/**\n * Incremental refresh. Deterministic facts are re-derived on the spot; everything else is re-hashed against its cited\n * sources and only the facts whose evidence changed become STALE and enter the (optional) agent refresh prompt.\n */\nexport async function refreshWorkspace(o: ServiceOptions): Promise<RefreshResult> {\n  return mutate(o, async (ws) => {\n    const project = await loadProject(ws);\n    const now = isoNow(o);\n    const run = await runDiscovery(ws, project.name, project.settings.maxFiles);\n    let previous: AnalysisState | null = null;\n    if (await pathExists(ws.analysisState)) {\n      previous = (await readVersioned(ws.analysisState, 'analysis', SCHEMA_VERSION, validateAnalysisState)).data;\n    }\n    const headChanged = !!previous && previous.gitHead !== run.gitHead;\n\n    if (o.dryRun) {\n      const facts = await loadFacts(ws);\n      const view = await evaluateStaleness(ws.root, facts, now);\n      const valueOf = (key: string): string => facts.facts.find((f) => f.key === key)?.value ?? '';\n      return {\n        dryRun: true,\n        headChanged,\n        autoRefreshed: [],\n        retired: [],\n        stale: [...view.recorded, ...view.detected].map((s) => ({ ...s, value: valueOf(s.key) })),\n        needsReview: view.needsReview,\n        prompt: null,\n      };\n    }\n\n    await writeJsonIfChanged(ws.discovery, run.discovery);\n    await writeCommands(ws, run.discovery.commands, { truncated: run.discovery.scan.truncated });\n    const det = await applyDetectorFacts(ws, run.discovery, now);\n\n    const facts = await loadFacts(ws);\n    const rep = await applyStaleness(ws.root, facts, now);\n    await saveFacts(ws, facts);\n\n    const stale = facts.facts.filter((f) => f.status === 'STALE' && f.sourceType !== 'detector').map((f) => ({ key: f.key, value: f.value, reason: f.staleReason ?? 'evidence changed' }));\n    let prompt: string | null = null;\n    if (stale.length > 0 || rep.needsReview.length > 0) {\n      await writeTextIfChanged(\n        ws.refreshPrompt,\n        buildRefreshPrompt({ projectName: project.name, stale, needsReview: rep.needsReview, autoRefreshed: det.written, cliVersion: packageVersion() }),\n      );\n      prompt = path.relative(ws.root, ws.refreshPrompt).replace(/\\\\/g, '/');\n    }\n\n    const state: AnalysisState = {\n      schemaVersion: SCHEMA_VERSION,\n      analyzedAt: previous?.analyzedAt ?? now,\n      refreshedAt: now,\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, headChanged, autoRefreshed: det.written, retired: det.retired, stale, needsReview: rep.needsReview, prompt };\n  });\n}\n"]}
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../../src/services/refresh.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'node:path';\nimport { SCHEMA_VERSION, validateAnalysisState, type AnalysisState } from '../config/schemas.js';\nimport { loadProject } from '../core/workspace.js';\nimport { readVersioned, writeVersioned } from '../core/versioned.js';\nimport { packageVersion } from '../core/version.js';\nimport { applyStaleness, evaluateStaleness, loadFacts, saveFacts } from '../knowledge/facts.js';\nimport { buildRefreshPrompt } from '../prompts/refresh.js';\nimport { pathExists, sha256Text, writeJsonIfChanged, writeTextIfChanged } from '../utils/fs.js';\nimport { applyDetectorFacts, runDiscovery, writeCommands } from './analysis.js';\nimport { isoNow, mutate, type ServiceOptions } from './common.js';\n\nexport interface RefreshResult {\n  dryRun: boolean;\n  headChanged: boolean;\n  autoRefreshed: string[];\n  retired: string[];\n  stale: { key: string; value: string; reason: string }[];\n  needsReview: { key: string; reason: string }[];\n  prompt: string | null;\n}\n\n/**\n * Incremental refresh. Deterministic facts are re-derived on the spot; everything else is re-hashed against its cited\n * sources and only the facts whose evidence changed become STALE and enter the (optional) agent refresh prompt.\n */\nexport async function refreshWorkspace(o: ServiceOptions): Promise<RefreshResult> {\n  return mutate(o, async (ws) => {\n    const project = await loadProject(ws);\n    const now = isoNow(o);\n    const run = await runDiscovery(ws, project.name, project.settings.maxFiles, { writeCache: !o.dryRun });\n    let previous: AnalysisState | null = null;\n    if (await pathExists(ws.analysisState)) {\n      previous = (await readVersioned(ws.analysisState, 'analysis', SCHEMA_VERSION, validateAnalysisState)).data;\n    }\n    const headChanged = !!previous && previous.gitHead !== run.gitHead;\n\n    if (o.dryRun) {\n      const facts = await loadFacts(ws);\n      const view = await evaluateStaleness(ws.root, facts, now);\n      const valueOf = (key: string): string => facts.facts.find((f) => f.key === key)?.value ?? '';\n      return {\n        dryRun: true,\n        headChanged,\n        autoRefreshed: [],\n        retired: [],\n        stale: [...view.recorded, ...view.detected].map((s) => ({ ...s, value: valueOf(s.key) })),\n        needsReview: view.needsReview,\n        prompt: null,\n      };\n    }\n\n    await writeJsonIfChanged(ws.discovery, run.discovery);\n    await writeCommands(ws, run.discovery.commands, { truncated: run.discovery.scan.truncated });\n    const det = await applyDetectorFacts(ws, run.discovery, now);\n\n    const facts = await loadFacts(ws);\n    const rep = await applyStaleness(ws.root, facts, now);\n    await saveFacts(ws, facts);\n\n    const stale = facts.facts.filter((f) => f.status === 'STALE' && f.sourceType !== 'detector').map((f) => ({ key: f.key, value: f.value, reason: f.staleReason ?? 'evidence changed' }));\n    let prompt: string | null = null;\n    if (stale.length > 0 || rep.needsReview.length > 0) {\n      await writeTextIfChanged(\n        ws.refreshPrompt,\n        buildRefreshPrompt({ projectName: project.name, stale, needsReview: rep.needsReview, autoRefreshed: det.written, cliVersion: packageVersion() }),\n      );\n      prompt = path.relative(ws.root, ws.refreshPrompt).replace(/\\\\/g, '/');\n    }\n\n    const state: AnalysisState = {\n      schemaVersion: SCHEMA_VERSION,\n      analyzedAt: previous?.analyzedAt ?? now,\n      refreshedAt: now,\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, headChanged, autoRefreshed: det.written, retired: det.retired, stale, needsReview: rep.needsReview, prompt };\n  });\n}\n"]}

package/dist/services/taskContext.d.ts

@@ -0,0 +1,59 @@
+import { type CommandEntry, type Fact } from '../config/schemas.js';
+import type { TaskType } from '../tasks/task.js';
+import { type ContextResult } from './knowledge.js';
+import type { ServiceOptions } from './common.js';
+export interface ContextItem {
+    kind: 'fact' | 'check' | 'decision' | 'document' | 'rule';
+    id: string;
+    /** Why this item is in the context; every item carries one. */
+    reason: string;
+}
+export interface TaskContextResult {
+    project: {
+        name: string;
+        id: string;
+    };
+    request: string;
+    type: TaskType;
+    confidence: 'high' | 'low';
+    readOnly: boolean;
+    /** `clipped` = characters left out of a long detector-derived value; the full value is in facts.json. */
+    facts: (Fact & {
+        clipped?: number;
+    })[];
+    /** Detector facts folded into another fact with the identical value; nothing is deleted from facts.json. */
+    aliases: {
+        key: string;
+        sameAs: string;
+    }[];
+    checks: CommandEntry[];
+    safety: ContextResult['safety'];
+    rules: string[];
+    decisions: {
+        number: number;
+        title: string;
+        status: string;
+        file: string;
+    }[];
+    /** Detailed documents are referenced by name, never embedded. */
+    documents: {
+        name: string;
+        bytes: number;
+    }[];
+    packages: string[];
+    included: ContextItem[];
+    counts: {
+        facts: [number, number];
+        checks: [number, number];
+        decisions: [number, number];
+        documents: [number, number];
+    };
+}
+/**
+ * Task-aware context. Selection is deterministic (sorted inputs, no clocks, no randomness) and rule-based: the request is
+ * classified, its keywords select facts/decisions/packages, and the type decides which broader groups come along.
+ * Safety rules are included for every type; the per-package "not run automatically" list whenever checks are included.
+ */
+export declare function getTaskContext(o: ServiceOptions, opts: {
+    request: string;
+}): Promise<TaskContextResult>;