devworkspace 0.0.0-stage → 0.1.1

package/dist/services/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/services/records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAqC,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAmC,MAAM,wBAAwB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAuB,MAAM,aAAa,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,CAAiB,EAAE,KAAoB;IAC1E,OAAO,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,CAAiB;IAClD,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,CAAC,MAAM,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,CAAiB,EAAE,MAAc;IACjE,MAAM,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACnE,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,iBAAiB,CAAC,WAAW,EAAE,sBAAsB,MAAM,GAAG,CAAC,CAAC;IAClF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,CAAiB,EAAE,KAAmB;IACxE,OAAO,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,CAAiB,EAAE,KAAK,GAAG,EAAE;IAC7D,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC","sourcesContent":["import { requireWorkspace } from '../core/workspace.js';\nimport { addDecision, listDecisions, type Decision, type DecisionInput } from '../decisions/decision.js';\nimport { listSessions, saveSession, type Session, type SessionInput } from '../sessions/session.js';\nimport { DevWorkspaceError } from '../errors/index.js';\nimport { isoNow, mutate, type ServiceOptions } from './common.js';\n\nexport async function recordDecision(o: ServiceOptions, input: DecisionInput): Promise<Decision> {\n  return mutate(o, (ws) => addDecision(ws, input, isoNow(o)));\n}\n\nexport async function getDecisions(o: ServiceOptions): Promise<Decision[]> {\n  const ws = await requireWorkspace(o.cwd);\n  return (await listDecisions(ws)).decisions;\n}\n\nexport async function getDecision(o: ServiceOptions, number: number): Promise<Decision> {\n  const d = (await getDecisions(o)).find((x) => x.number === number);\n  if (!d) throw new DevWorkspaceError('NOT_FOUND', `No decision number ${number}.`);\n  return d;\n}\n\nexport async function recordSession(o: ServiceOptions, input: SessionInput): Promise<Session> {\n  return mutate(o, (ws) => saveSession(ws, input, isoNow(o)));\n}\n\nexport async function getSessions(o: ServiceOptions, limit = 10): Promise<Session[]> {\n  const ws = await requireWorkspace(o.cwd);\n  return listSessions(ws, limit);\n}\n"]}

package/dist/services/refresh.d.ts

@@ -0,0 +1,22 @@
+import { type ServiceOptions } from './common.js';
+export interface RefreshResult {
+    dryRun: boolean;
+    headChanged: boolean;
+    autoRefreshed: string[];
+    retired: string[];
+    stale: {
+        key: string;
+        value: string;
+        reason: string;
+    }[];
+    needsReview: {
+        key: string;
+        reason: string;
+    }[];
+    prompt: string | null;
+}
+/**
+ * Incremental refresh. Deterministic facts are re-derived on the spot; everything else is re-hashed against its cited
+ * sources and only the facts whose evidence changed become STALE and enter the (optional) agent refresh prompt.
+ */
+export declare function refreshWorkspace(o: ServiceOptions): Promise<RefreshResult>;

package/dist/services/refresh.js

@@ -0,0 +1,64 @@
+import path from 'node:path';
+import { SCHEMA_VERSION, validateAnalysisState } from '../config/schemas.js';
+import { loadProject } from '../core/workspace.js';
+import { readVersioned, writeVersioned } from '../core/versioned.js';
+import { packageVersion } from '../core/version.js';
+import { applyStaleness, loadFacts, saveFacts } from '../knowledge/facts.js';
+import { buildRefreshPrompt } from '../prompts/refresh.js';
+import { pathExists, sha256Text, writeJsonIfChanged, writeTextIfChanged } from '../utils/fs.js';
+import { applyDetectorFacts, runDiscovery, writeCommands } from './analysis.js';
+import { isoNow, mutate } from './common.js';
+/**
+ * Incremental refresh. Deterministic facts are re-derived on the spot; everything else is re-hashed against its cited
+ * sources and only the facts whose evidence changed become STALE and enter the (optional) agent refresh prompt.
+ */
+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);
+        let previous = null;
+        if (await pathExists(ws.analysisState)) {
+            previous = (await readVersioned(ws.analysisState, 'analysis', SCHEMA_VERSION, validateAnalysisState)).data;
+        }
+        const headChanged = !!previous && previous.gitHead !== run.gitHead;
+        if (o.dryRun) {
+            const facts = await loadFacts(ws);
+            const probe = structuredClone(facts);
+            const rep = await applyStaleness(ws.root, probe, now);
+            return {
+                dryRun: true,
+                headChanged,
+                autoRefreshed: [],
+                retired: [],
+                stale: rep.newlyStale.map((s) => ({ ...s, value: probe.facts.find((f) => f.key === s.key)?.value ?? '' })),
+                needsReview: rep.needsReview,
+                prompt: null,
+            };
+        }
+        await writeJsonIfChanged(ws.discovery, run.discovery);
+        await writeCommands(ws, run.discovery.commands);
+        const det = await applyDetectorFacts(ws, run.discovery, now);
+        const facts = await loadFacts(ws);
+        const rep = await applyStaleness(ws.root, facts, now);
+        await saveFacts(ws, facts);
+        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' }));
+        let prompt = null;
+        if (stale.length > 0 || rep.needsReview.length > 0) {
+            await writeTextIfChanged(ws.refreshPrompt, buildRefreshPrompt({ projectName: project.name, stale, needsReview: rep.needsReview, autoRefreshed: det.written, cliVersion: packageVersion() }));
+            prompt = path.relative(ws.root, ws.refreshPrompt).replace(/\\/g, '/');
+        }
+        const state = {
+            schemaVersion: SCHEMA_VERSION,
+            analyzedAt: previous?.analyzedAt ?? now,
+            refreshedAt: now,
+            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, headChanged, autoRefreshed: det.written, retired: det.retired, stale, needsReview: rep.needsReview, prompt };
+    });
+}
+//# sourceMappingURL=refresh.js.map

package/dist/services/refresh.js.map

@@ -0,0 +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, 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 probe = structuredClone(facts);\n      const rep = await applyStaleness(ws.root, probe, now);\n      return {\n        dryRun: true,\n        headChanged,\n        autoRefreshed: [],\n        retired: [],\n        stale: rep.newlyStale.map((s) => ({ ...s, value: probe.facts.find((f) => f.key === s.key)?.value ?? '' })),\n        needsReview: rep.needsReview,\n        prompt: null,\n      };\n    }\n\n    await writeJsonIfChanged(ws.discovery, run.discovery);\n    await writeCommands(ws, run.discovery.commands);\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/reset.d.ts

@@ -0,0 +1,23 @@
+import type { ServiceOptions } from './common.js';
+export interface ResetOptions extends ServiceOptions {
+    /** Actually delete. Without it, reset only reports what it would remove. */
+    confirm?: boolean;
+    /** Also remove the DevWorkspace block from CLAUDE.md and the managed devworkspace skill. */
+    includeAgentFiles?: boolean;
+}
+export interface ResetAction {
+    path: string;
+    action: 'delete-folder' | 'remove-managed-section' | 'delete-file' | 'skip';
+    note: string;
+}
+export interface ResetResult {
+    root: string;
+    executed: boolean;
+    actions: ResetAction[];
+    fileCount: number;
+}
+/**
+ * Remove .devworkspace/ so the user can start again with `init`. Only DevWorkspace's own folder is ever deleted;
+ * application files are never touched, and with includeAgentFiles only the managed block / managed skill are removed.
+ */
+export declare function resetWorkspace(o: ResetOptions): Promise<ResetResult>;

package/dist/services/reset.js

@@ -0,0 +1,96 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { removeManagedSection } from '../agents/claude/adapter.js';
+import { SKILL_MARKER, SKILL_PATH } from '../agents/claude/content.js';
+import { DevWorkspaceError } from '../errors/index.js';
+import { findWorkspaceRoot, WORKSPACE_DIR, wsPaths } from '../core/workspace.js';
+import { atomicWriteFile, pathExists } from '../utils/fs.js';
+import { isInside } from '../utils/paths.js';
+import { withLock } from '../utils/lock.js';
+async function countFiles(dir) {
+    let n = 0;
+    for (const e of await fs.readdir(dir, { withFileTypes: true })) {
+        if (e.isDirectory())
+            n += await countFiles(path.join(dir, e.name));
+        else
+            n++;
+    }
+    return n;
+}
+/**
+ * Remove .devworkspace/ so the user can start again with `init`. Only DevWorkspace's own folder is ever deleted;
+ * application files are never touched, and with includeAgentFiles only the managed block / managed skill are removed.
+ */
+export async function resetWorkspace(o) {
+    let root = await findWorkspaceRoot(o.cwd);
+    if (!root && (await pathExists(path.join(o.cwd, WORKSPACE_DIR))))
+        root = path.resolve(o.cwd); // half-initialised workspace
+    if (!root) {
+        throw new DevWorkspaceError('NOT_FOUND', 'No .devworkspace folder found in this directory or any parent.', { hint: 'Nothing to reset.' });
+    }
+    const ws = wsPaths(root);
+    const st = await fs.lstat(ws.dir);
+    if (st.isSymbolicLink() || !st.isDirectory()) {
+        throw new DevWorkspaceError('UNSAFE_PATH', '.devworkspace is a symlink or not a directory; refusing to delete it.', {
+            hint: 'Remove it by hand if you are sure.',
+        });
+    }
+    const real = await fs.realpath(ws.dir);
+    if (!isInside(await fs.realpath(root), real) || path.basename(real) !== WORKSPACE_DIR) {
+        throw new DevWorkspaceError('UNSAFE_PATH', 'Resolved workspace path is outside the project; refusing to delete it.');
+    }
+    const fileCount = await countFiles(ws.dir);
+    const actions = [
+        { path: `${WORKSPACE_DIR}/`, action: 'delete-folder', note: `${fileCount} file(s): knowledge, decisions, tasks, sessions, analysis and local state` },
+    ];
+    const pending = [];
+    if (o.includeAgentFiles) {
+        for (const rel of ['CLAUDE.md', '.claude/CLAUDE.md']) {
+            const full = path.join(root, ...rel.split('/'));
+            const text = await fs.readFile(full, 'utf8').catch(() => null);
+            if (text === null)
+                continue;
+            const removed = removeManagedSection(text);
+            if (!removed) {
+                if (text.includes('<!-- devworkspace:start') || text.includes('<!-- devworkspace:end')) {
+                    actions.push({ path: rel, action: 'skip', note: 'managed markers are unbalanced; edit by hand' });
+                }
+                continue;
+            }
+            if (removed.empty) {
+                actions.push({ path: rel, action: 'delete-file', note: 'contained only the DevWorkspace block' });
+                pending.push(() => fs.rm(full, { force: true }));
+            }
+            else {
+                actions.push({ path: rel, action: 'remove-managed-section', note: 'your own content is kept' });
+                pending.push(() => atomicWriteFile(full, removed.content));
+            }
+        }
+        const skillFile = path.join(root, ...SKILL_PATH.split('/'));
+        const skill = await fs.readFile(skillFile, 'utf8').catch(() => null);
+        if (skill !== null) {
+            if (skill.includes(SKILL_MARKER)) {
+                const dir = path.dirname(skillFile);
+                const others = (await fs.readdir(dir)).filter((n) => n !== 'SKILL.md');
+                actions.push({ path: SKILL_PATH, action: 'delete-file', note: 'DevWorkspace-managed skill' });
+                pending.push(async () => {
+                    await fs.rm(skillFile, { force: true });
+                    if (others.length === 0)
+                        await fs.rmdir(dir).catch(() => undefined);
+                });
+            }
+            else {
+                actions.push({ path: SKILL_PATH, action: 'skip', note: 'not managed by DevWorkspace (no marker); left alone' });
+            }
+        }
+    }
+    if (!o.confirm || o.dryRun)
+        return { root, executed: false, actions, fileCount };
+    await withLock(ws.dir, async () => {
+        for (const w of pending)
+            await w();
+    });
+    await fs.rm(ws.dir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+    return { root, executed: true, actions, fileCount };
+}
+//# sourceMappingURL=reset.js.map

package/dist/services/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../src/services/reset.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { removeManagedSection } from '../agents/claude/adapter.js';\nimport { SKILL_MARKER, SKILL_PATH } from '../agents/claude/content.js';\nimport { DevWorkspaceError } from '../errors/index.js';\nimport { findWorkspaceRoot, WORKSPACE_DIR, wsPaths } from '../core/workspace.js';\nimport { atomicWriteFile, pathExists } from '../utils/fs.js';\nimport { isInside } from '../utils/paths.js';\nimport { withLock } from '../utils/lock.js';\nimport type { ServiceOptions } from './common.js';\n\nexport interface ResetOptions extends ServiceOptions {\n  /** Actually delete. Without it, reset only reports what it would remove. */\n  confirm?: boolean;\n  /** Also remove the DevWorkspace block from CLAUDE.md and the managed devworkspace skill. */\n  includeAgentFiles?: boolean;\n}\n\nexport interface ResetAction {\n  path: string;\n  action: 'delete-folder' | 'remove-managed-section' | 'delete-file' | 'skip';\n  note: string;\n}\n\nexport interface ResetResult {\n  root: string;\n  executed: boolean;\n  actions: ResetAction[];\n  fileCount: number;\n}\n\nasync function countFiles(dir: string): Promise<number> {\n  let n = 0;\n  for (const e of await fs.readdir(dir, { withFileTypes: true })) {\n    if (e.isDirectory()) n += await countFiles(path.join(dir, e.name));\n    else n++;\n  }\n  return n;\n}\n\n/**\n * Remove .devworkspace/ so the user can start again with `init`. Only DevWorkspace's own folder is ever deleted;\n * application files are never touched, and with includeAgentFiles only the managed block / managed skill are removed.\n */\nexport async function resetWorkspace(o: ResetOptions): Promise<ResetResult> {\n  let root = await findWorkspaceRoot(o.cwd);\n  if (!root && (await pathExists(path.join(o.cwd, WORKSPACE_DIR)))) root = path.resolve(o.cwd); // half-initialised workspace\n  if (!root) {\n    throw new DevWorkspaceError('NOT_FOUND', 'No .devworkspace folder found in this directory or any parent.', { hint: 'Nothing to reset.' });\n  }\n  const ws = wsPaths(root);\n  const st = await fs.lstat(ws.dir);\n  if (st.isSymbolicLink() || !st.isDirectory()) {\n    throw new DevWorkspaceError('UNSAFE_PATH', '.devworkspace is a symlink or not a directory; refusing to delete it.', {\n      hint: 'Remove it by hand if you are sure.',\n    });\n  }\n  const real = await fs.realpath(ws.dir);\n  if (!isInside(await fs.realpath(root), real) || path.basename(real) !== WORKSPACE_DIR) {\n    throw new DevWorkspaceError('UNSAFE_PATH', 'Resolved workspace path is outside the project; refusing to delete it.');\n  }\n\n  const fileCount = await countFiles(ws.dir);\n  const actions: ResetAction[] = [\n    { path: `${WORKSPACE_DIR}/`, action: 'delete-folder', note: `${fileCount} file(s): knowledge, decisions, tasks, sessions, analysis and local state` },\n  ];\n  const pending: (() => Promise<void>)[] = [];\n\n  if (o.includeAgentFiles) {\n    for (const rel of ['CLAUDE.md', '.claude/CLAUDE.md']) {\n      const full = path.join(root, ...rel.split('/'));\n      const text = await fs.readFile(full, 'utf8').catch(() => null);\n      if (text === null) continue;\n      const removed = removeManagedSection(text);\n      if (!removed) {\n        if (text.includes('<!-- devworkspace:start') || text.includes('<!-- devworkspace:end')) {\n          actions.push({ path: rel, action: 'skip', note: 'managed markers are unbalanced; edit by hand' });\n        }\n        continue;\n      }\n      if (removed.empty) {\n        actions.push({ path: rel, action: 'delete-file', note: 'contained only the DevWorkspace block' });\n        pending.push(() => fs.rm(full, { force: true }));\n      } else {\n        actions.push({ path: rel, action: 'remove-managed-section', note: 'your own content is kept' });\n        pending.push(() => atomicWriteFile(full, removed.content));\n      }\n    }\n    const skillFile = path.join(root, ...SKILL_PATH.split('/'));\n    const skill = await fs.readFile(skillFile, 'utf8').catch(() => null);\n    if (skill !== null) {\n      if (skill.includes(SKILL_MARKER)) {\n        const dir = path.dirname(skillFile);\n        const others = (await fs.readdir(dir)).filter((n) => n !== 'SKILL.md');\n        actions.push({ path: SKILL_PATH, action: 'delete-file', note: 'DevWorkspace-managed skill' });\n        pending.push(async () => {\n          await fs.rm(skillFile, { force: true });\n          if (others.length === 0) await fs.rmdir(dir).catch(() => undefined);\n        });\n      } else {\n        actions.push({ path: SKILL_PATH, action: 'skip', note: 'not managed by DevWorkspace (no marker); left alone' });\n      }\n    }\n  }\n\n  if (!o.confirm || o.dryRun) return { root, executed: false, actions, fileCount };\n\n  await withLock(ws.dir, async () => {\n    for (const w of pending) await w();\n  });\n  await fs.rm(ws.dir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });\n  return { root, executed: true, actions, fileCount };\n}\n"]}

package/dist/services/status.d.ts

@@ -0,0 +1,57 @@
+import { type Ws } from '../core/workspace.js';
+import { type IntegrationStatus } from '../integrations/index.js';
+import { type ServiceOptions } from './common.js';
+export interface TaskBrief {
+    id: string;
+    title: string;
+    type: string;
+    status: string;
+    updatedAt: string;
+    next: string;
+}
+export interface StatusResult {
+    initialized: boolean;
+    root: string | null;
+    project: {
+        name: string;
+        id: string;
+    } | null;
+    workspace: 'Healthy' | 'Needs attention' | 'Not initialized' | 'Unreadable';
+    workspaceProblem?: string;
+    git: {
+        available: boolean;
+        isRepo: boolean;
+        branch: string | null;
+        workingTree: 'Clean' | 'Modified' | 'Unknown';
+        changes: number;
+    };
+    knowledge: {
+        state: 'Current' | 'Stale' | 'Empty' | 'Unknown';
+        facts: number;
+        stale: number;
+        analyzedAt: string | null;
+    };
+    onboarding: {
+        instructionsInstalled: boolean;
+        knowledgeWritten: boolean;
+        ready: boolean;
+    };
+    integrations: IntegrationStatus[];
+    activeTasks: TaskBrief[];
+    verification: {
+        id: string;
+        available: boolean;
+        command: string | null;
+        required: string;
+    }[];
+    lastSession: {
+        id: string;
+        goal: string;
+        next: string;
+    } | null;
+    corruptTasks: number;
+}
+export declare function instructionsInstalled(ws: Ws): Promise<boolean>;
+export declare function knowledgeWritten(ws: Ws): Promise<boolean>;
+/** Cheap overview: reads small workspace files and Git status only. Never hashes or scans source files. */
+export declare function getStatus(o: ServiceOptions): Promise<StatusResult>;

package/dist/services/status.js

@@ -0,0 +1,111 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { SCHEMA_VERSION, validateAnalysisState, validateCommands } from '../config/schemas.js';
+import { findWorkspaceRoot, loadProject, wsPaths } from '../core/workspace.js';
+import { readVersioned } from '../core/versioned.js';
+import { getGitState } from '../git/git.js';
+import { detectIntegrations } from '../integrations/index.js';
+import { loadFacts } from '../knowledge/facts.js';
+import { listSessions } from '../sessions/session.js';
+import { listTasks, nextRequiredStep } from '../tasks/task.js';
+import { pathExists } from '../utils/fs.js';
+import { SECTION_END } from '../agents/claude/content.js';
+import { SKILL_PATH } from '../agents/claude/content.js';
+import { integrationCtx } from './common.js';
+const brief = (t) => ({ id: t.id, title: t.title, type: t.type, status: t.status, updatedAt: t.updatedAt, next: nextRequiredStep(t) });
+export async function instructionsInstalled(ws) {
+    for (const rel of ['CLAUDE.md', '.claude/CLAUDE.md']) {
+        try {
+            const text = await fs.readFile(path.join(ws.root, ...rel.split('/')), 'utf8');
+            if (text.includes('<!-- devworkspace:start') && text.includes(SECTION_END) && (await pathExists(path.join(ws.root, ...SKILL_PATH.split('/')))))
+                return true;
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return false;
+}
+export async function knowledgeWritten(ws) {
+    try {
+        return (await fs.stat(path.join(ws.contextDir, 'architecture.md'))).size >= 200;
+    }
+    catch {
+        return false;
+    }
+}
+/** Cheap overview: reads small workspace files and Git status only. Never hashes or scans source files. */
+export async function getStatus(o) {
+    const root = await findWorkspaceRoot(o.cwd);
+    const git = await getGitState(root ?? o.cwd);
+    const gitBrief = {
+        available: git.available,
+        isRepo: git.isRepo,
+        branch: git.branch,
+        workingTree: git.isRepo ? (git.dirty ? 'Modified' : 'Clean') : 'Unknown',
+        changes: git.entries.length,
+    };
+    const base = {
+        initialized: false,
+        root,
+        project: null,
+        workspace: 'Not initialized',
+        git: gitBrief,
+        knowledge: { state: 'Unknown', facts: 0, stale: 0, analyzedAt: null },
+        onboarding: { instructionsInstalled: false, knowledgeWritten: false, ready: false },
+        integrations: [],
+        activeTasks: [],
+        verification: [],
+        lastSession: null,
+        corruptTasks: 0,
+    };
+    if (!root)
+        return base;
+    const ws = wsPaths(root);
+    base.initialized = true;
+    try {
+        const project = await loadProject(ws);
+        base.project = { name: project.name, id: project.projectId };
+        base.workspace = 'Healthy';
+    }
+    catch (e) {
+        return { ...base, workspace: 'Unreadable', workspaceProblem: e.message };
+    }
+    try {
+        const facts = await loadFacts(ws);
+        const stale = facts.facts.filter((f) => f.status === 'STALE').length;
+        let analyzedAt = null;
+        if (await pathExists(ws.analysisState)) {
+            analyzedAt = (await readVersioned(ws.analysisState, 'analysis', SCHEMA_VERSION, validateAnalysisState)).data.analyzedAt;
+        }
+        base.knowledge = { facts: facts.facts.length, stale, analyzedAt, state: facts.facts.length === 0 ? 'Empty' : stale > 0 ? 'Stale' : 'Current' };
+    }
+    catch (e) {
+        base.workspace = 'Needs attention';
+        base.workspaceProblem = e.message;
+    }
+    if (await pathExists(ws.commands)) {
+        try {
+            const commands = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data;
+            base.verification = commands.checks.map((c) => ({ id: c.id, available: c.available, command: c.command, required: c.required }));
+        }
+        catch (e) {
+            base.workspace = 'Needs attention';
+            base.workspaceProblem ??= e.message;
+        }
+    }
+    const { tasks, corrupt } = await listTasks(ws);
+    base.activeTasks = tasks.map(brief);
+    base.corruptTasks = corrupt.length;
+    if (corrupt.length > 0)
+        base.workspace = 'Needs attention';
+    const sessions = await listSessions(ws, 1);
+    if (sessions[0])
+        base.lastSession = { id: sessions[0].id, goal: sessions[0].goal, next: sessions[0].next };
+    base.integrations = await detectIntegrations(integrationCtx(o, root));
+    base.onboarding.instructionsInstalled = await instructionsInstalled(ws);
+    base.onboarding.knowledgeWritten = await knowledgeWritten(ws);
+    base.onboarding.ready = base.onboarding.instructionsInstalled && base.onboarding.knowledgeWritten && base.knowledge.state !== 'Empty';
+    return base;
+}
+//# sourceMappingURL=status.js.map

package/dist/services/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/services/status.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, type CommandEntry } from '../config/schemas.js';\nimport { findWorkspaceRoot, loadProject, wsPaths, type Ws } from '../core/workspace.js';\nimport { readVersioned } from '../core/versioned.js';\nimport { getGitState } from '../git/git.js';\nimport { detectIntegrations, type IntegrationStatus } from '../integrations/index.js';\nimport { loadFacts } from '../knowledge/facts.js';\nimport { listSessions } from '../sessions/session.js';\nimport { listTasks, nextRequiredStep, type Task } from '../tasks/task.js';\nimport { pathExists } from '../utils/fs.js';\nimport { SECTION_END } from '../agents/claude/content.js';\nimport { SKILL_PATH } from '../agents/claude/content.js';\nimport { integrationCtx, type ServiceOptions } from './common.js';\n\nexport interface TaskBrief {\n  id: string;\n  title: string;\n  type: string;\n  status: string;\n  updatedAt: string;\n  next: string;\n}\n\nexport interface StatusResult {\n  initialized: boolean;\n  root: string | null;\n  project: { name: string; id: string } | null;\n  workspace: 'Healthy' | 'Needs attention' | 'Not initialized' | 'Unreadable';\n  workspaceProblem?: string;\n  git: { available: boolean; isRepo: boolean; branch: string | null; workingTree: 'Clean' | 'Modified' | 'Unknown'; changes: number };\n  knowledge: { state: 'Current' | 'Stale' | 'Empty' | 'Unknown'; facts: number; stale: number; analyzedAt: string | null };\n  onboarding: { instructionsInstalled: boolean; knowledgeWritten: boolean; ready: boolean };\n  integrations: IntegrationStatus[];\n  activeTasks: TaskBrief[];\n  verification: { id: string; available: boolean; command: string | null; required: string }[];\n  lastSession: { id: string; goal: string; next: string } | null;\n  corruptTasks: number;\n}\n\nconst brief = (t: Task): TaskBrief => ({ id: t.id, title: t.title, type: t.type, status: t.status, updatedAt: t.updatedAt, next: nextRequiredStep(t) });\n\nexport async function instructionsInstalled(ws: Ws): Promise<boolean> {\n  for (const rel of ['CLAUDE.md', '.claude/CLAUDE.md']) {\n    try {\n      const text = await fs.readFile(path.join(ws.root, ...rel.split('/')), 'utf8');\n      if (text.includes('<!-- devworkspace:start') && text.includes(SECTION_END) && (await pathExists(path.join(ws.root, ...SKILL_PATH.split('/'))))) return true;\n    } catch {\n      /* try next */\n    }\n  }\n  return false;\n}\n\nexport async function knowledgeWritten(ws: Ws): Promise<boolean> {\n  try {\n    return (await fs.stat(path.join(ws.contextDir, 'architecture.md'))).size >= 200;\n  } catch {\n    return false;\n  }\n}\n\n/** Cheap overview: reads small workspace files and Git status only. Never hashes or scans source files. */\nexport async function getStatus(o: ServiceOptions): Promise<StatusResult> {\n  const root = await findWorkspaceRoot(o.cwd);\n  const git = await getGitState(root ?? o.cwd);\n  const gitBrief: StatusResult['git'] = {\n    available: git.available,\n    isRepo: git.isRepo,\n    branch: git.branch,\n    workingTree: git.isRepo ? (git.dirty ? 'Modified' : 'Clean') : 'Unknown',\n    changes: git.entries.length,\n  };\n  const base: StatusResult = {\n    initialized: false,\n    root,\n    project: null,\n    workspace: 'Not initialized',\n    git: gitBrief,\n    knowledge: { state: 'Unknown', facts: 0, stale: 0, analyzedAt: null },\n    onboarding: { instructionsInstalled: false, knowledgeWritten: false, ready: false },\n    integrations: [],\n    activeTasks: [],\n    verification: [],\n    lastSession: null,\n    corruptTasks: 0,\n  };\n  if (!root) return base;\n\n  const ws = wsPaths(root);\n  base.initialized = true;\n  try {\n    const project = await loadProject(ws);\n    base.project = { name: project.name, id: project.projectId };\n    base.workspace = 'Healthy';\n  } catch (e) {\n    return { ...base, workspace: 'Unreadable', workspaceProblem: (e as Error).message };\n  }\n\n  try {\n    const facts = await loadFacts(ws);\n    const stale = facts.facts.filter((f) => f.status === 'STALE').length;\n    let analyzedAt: string | null = null;\n    if (await pathExists(ws.analysisState)) {\n      analyzedAt = (await readVersioned(ws.analysisState, 'analysis', SCHEMA_VERSION, validateAnalysisState)).data.analyzedAt;\n    }\n    base.knowledge = { facts: facts.facts.length, stale, analyzedAt, state: facts.facts.length === 0 ? 'Empty' : stale > 0 ? 'Stale' : 'Current' };\n  } catch (e) {\n    base.workspace = 'Needs attention';\n    base.workspaceProblem = (e as Error).message;\n  }\n\n  if (await pathExists(ws.commands)) {\n    try {\n      const commands = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data;\n      base.verification = commands.checks.map((c: CommandEntry) => ({ id: c.id, available: c.available, command: c.command, required: c.required }));\n    } catch (e) {\n      base.workspace = 'Needs attention';\n      base.workspaceProblem ??= (e as Error).message;\n    }\n  }\n\n  const { tasks, corrupt } = await listTasks(ws);\n  base.activeTasks = tasks.map(brief);\n  base.corruptTasks = corrupt.length;\n  if (corrupt.length > 0) base.workspace = 'Needs attention';\n  const sessions = await listSessions(ws, 1);\n  if (sessions[0]) base.lastSession = { id: sessions[0].id, goal: sessions[0].goal, next: sessions[0].next };\n\n  base.integrations = await detectIntegrations(integrationCtx(o, root));\n  base.onboarding.instructionsInstalled = await instructionsInstalled(ws);\n  base.onboarding.knowledgeWritten = await knowledgeWritten(ws);\n  base.onboarding.ready = base.onboarding.instructionsInstalled && base.onboarding.knowledgeWritten && base.knowledge.state !== 'Empty';\n  return base;\n}\n"]}

package/dist/services/tasks.d.ts

@@ -0,0 +1,44 @@
+import { type Classification, type WorkflowSpec } from '../tasks/routing.js';
+import { listTasks, type GateResult, type Task } from '../tasks/task.js';
+import { type ServiceOptions } from './common.js';
+export interface CreateTaskResult {
+    task: Task;
+    classification: Classification;
+    workflow: WorkflowSpec;
+}
+export declare function createTask(o: ServiceOptions, input: {
+    text: string;
+    type?: string;
+    title?: string;
+}): Promise<CreateTaskResult>;
+export declare function showTask(o: ServiceOptions, id: string): Promise<{
+    task: Task;
+    gate: GateResult;
+}>;
+export declare function listTasksService(o: ServiceOptions, includeCompleted?: boolean): ReturnType<typeof listTasks>;
+export interface TaskPatch {
+    title?: string;
+    summary?: string;
+    criteria?: string[];
+    plan?: string[];
+    areas?: string[];
+    decisions?: string[];
+    blockers?: string[];
+    clearBlockers?: boolean;
+    require?: string[];
+}
+export declare function updateTask(o: ServiceOptions, id: string, patch: TaskPatch): Promise<Task>;
+export declare function setTaskStatus(o: ServiceOptions, id: string, status: string, note?: string): Promise<{
+    task: Task;
+    gate: GateResult | null;
+}>;
+export declare function recordVerification(o: ServiceOptions, id: string, check: string, result: string, extra?: {
+    reason?: string;
+    detail?: string;
+}): Promise<Task>;
+export declare function recordTests(o: ServiceOptions, id: string, phase: 'baseline' | 'after', passed: number, failed: number): Promise<Task>;
+export declare function attestTask(o: ServiceOptions, id: string, flags: {
+    userWorkIntact?: boolean;
+    knowledgeReviewed?: boolean;
+    finalStateInspected?: boolean;
+}): Promise<Task>;

package/dist/services/tasks.js

@@ -0,0 +1,136 @@
+import { SCHEMA_VERSION, validateCommands } from '../config/schemas.js';
+import { DevWorkspaceError } from '../errors/index.js';
+import { loadProject, requireWorkspace } from '../core/workspace.js';
+import { readVersioned } from '../core/versioned.js';
+import { classifyRequest, WORKFLOWS } from '../tasks/routing.js';
+import { assertNoSecrets, createTaskObject, evaluateGate, listTasks, loadTask, requiredChecksFor, saveTask, transitionTask, TASK_STATUSES, TASK_TYPES, VERIFY_STATUSES, } from '../tasks/task.js';
+import { pathExists } from '../utils/fs.js';
+import { isoNow, mutate } from './common.js';
+async function loadContract(ws) {
+    if (!(await pathExists(ws.commands)))
+        return [];
+    return (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data.checks;
+}
+export async function createTask(o, input) {
+    return mutate(o, async (ws) => {
+        const project = await loadProject(ws);
+        const classification = classifyRequest(input.text);
+        let type = classification.type;
+        if (input.type) {
+            const up = input.type.toUpperCase();
+            if (!TASK_TYPES.includes(up)) {
+                throw new DevWorkspaceError('USAGE', `Unknown task type "${input.type}".`, { hint: `Use one of: ${TASK_TYPES.join(', ')}.` });
+            }
+            type = up;
+        }
+        const contract = await loadContract(ws);
+        let verification = requiredChecksFor(type, contract, project.settings.review);
+        // Explicit user constraints stay visible: the check is kept but recorded as skipped at the user's request.
+        const skipChecks = new Set();
+        if (classification.constraints.includes('no-e2e'))
+            skipChecks.add('e2e');
+        if (classification.constraints.includes('no-tests'))
+            skipChecks.add('unit').add('integration').add('e2e');
+        verification = verification.map((v) => (skipChecks.has(v.check) ? { ...v, status: 'SKIPPED', reason: 'user-override' } : v));
+        const title = (input.title ?? input.text).replace(/\s+/g, ' ').trim().slice(0, 100);
+        const task = createTaskObject({ title, type, description: input.text, verification, constraints: classification.constraints }, isoNow(o));
+        await saveTask(ws, task);
+        return { task, classification: { ...classification, type }, workflow: WORKFLOWS[type] };
+    });
+}
+export async function showTask(o, id) {
+    const ws = await requireWorkspace(o.cwd);
+    const task = await loadTask(ws, id);
+    return { task, gate: evaluateGate(task) };
+}
+export async function listTasksService(o, includeCompleted = false) {
+    const ws = await requireWorkspace(o.cwd);
+    return listTasks(ws, { includeCompleted });
+}
+export async function updateTask(o, id, patch) {
+    return mutate(o, async (ws) => {
+        const task = await loadTask(ws, id);
+        if (patch.title)
+            task.title = patch.title.trim().slice(0, 200);
+        if (patch.summary !== undefined)
+            task.completionSummary = patch.summary.trim().slice(0, 4000);
+        task.acceptanceCriteria.push(...(patch.criteria ?? []));
+        task.plan.push(...(patch.plan ?? []));
+        task.affectedAreas.push(...(patch.areas ?? []).filter((a) => !task.affectedAreas.includes(a)));
+        task.decisions.push(...(patch.decisions ?? []));
+        if (patch.clearBlockers)
+            task.blockers = [];
+        task.blockers.push(...(patch.blockers ?? []));
+        for (const check of patch.require ?? []) {
+            if (!task.verification.some((v) => v.check === check))
+                task.verification.push({ check, required: true, status: 'PENDING' });
+        }
+        task.updatedAt = isoNow(o);
+        assertNoSecrets(task);
+        await saveTask(ws, task);
+        return task;
+    });
+}
+export async function setTaskStatus(o, id, status, note) {
+    const up = status.toUpperCase();
+    if (!TASK_STATUSES.includes(up)) {
+        throw new DevWorkspaceError('USAGE', `Unknown task status "${status}".`, { hint: `Use one of: ${TASK_STATUSES.join(', ')}.` });
+    }
+    return mutate(o, async (ws) => {
+        const task = await loadTask(ws, id);
+        const gate = transitionTask(task, up, isoNow(o), note);
+        if (up === 'BLOCKED' && note)
+            task.blockers.push(note.slice(0, 300));
+        await saveTask(ws, task);
+        return { task, gate };
+    });
+}
+export async function recordVerification(o, id, check, result, extra = {}) {
+    const status = result.toUpperCase();
+    const normalized = status === 'SKIP' ? 'SKIPPED' : status;
+    if (!VERIFY_STATUSES.includes(normalized)) {
+        throw new DevWorkspaceError('USAGE', `Unknown result "${result}".`, { hint: 'Use pass, fail, skip or pending.' });
+    }
+    return mutate(o, async (ws) => {
+        const task = await loadTask(ws, id);
+        let item = task.verification.find((v) => v.check === check);
+        if (!item) {
+            item = { check, required: false, status: 'PENDING' };
+            task.verification.push(item);
+        }
+        item.status = normalized;
+        item.updatedAt = isoNow(o);
+        if (extra.reason)
+            item.reason = extra.reason;
+        else
+            delete item.reason;
+        if (extra.detail)
+            item.detail = extra.detail.slice(0, 500);
+        task.updatedAt = item.updatedAt;
+        assertNoSecrets(task);
+        await saveTask(ws, task);
+        return task;
+    });
+}
+export async function recordTests(o, id, phase, passed, failed) {
+    if (!Number.isInteger(passed) || !Number.isInteger(failed) || passed < 0 || failed < 0) {
+        throw new DevWorkspaceError('USAGE', '--passed and --failed must be non-negative integers.');
+    }
+    return mutate(o, async (ws) => {
+        const task = await loadTask(ws, id);
+        task.tests[phase] = { passed, failed };
+        task.updatedAt = isoNow(o);
+        await saveTask(ws, task);
+        return task;
+    });
+}
+export async function attestTask(o, id, flags) {
+    return mutate(o, async (ws) => {
+        const task = await loadTask(ws, id);
+        task.attestations = { ...task.attestations, ...Object.fromEntries(Object.entries(flags).filter(([, v]) => v !== undefined)) };
+        task.updatedAt = isoNow(o);
+        await saveTask(ws, task);
+        return task;
+    });
+}
+//# sourceMappingURL=tasks.js.map