devworkspace 0.0.0-stage → 0.1.1

package/dist/services/init.js

@@ -0,0 +1,135 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { SCHEMA_VERSION, validateProject } from '../config/schemas.js';
+import { DevWorkspaceError } from '../errors/index.js';
+import { gitTopLevel } from '../git/git.js';
+import { detectIntegrations } from '../integrations/index.js';
+import { atomicWriteFile, atomicWriteJson, ensureDir, pathExists } from '../utils/fs.js';
+import { findWorkspaceRoot, LOCAL_GITIGNORE, loadProject, wsPaths, WORKSPACE_DIR } from '../core/workspace.js';
+import { packageVersion } from '../core/version.js';
+import { withLock } from '../utils/lock.js';
+import { readPackageJson } from '../discovery/detect.js';
+import { newProjectId } from './analysis.js';
+import { integrationCtx, isoNow } from './common.js';
+async function resolveRoot(o, notes) {
+    if (o.root)
+        return path.resolve(o.cwd, o.root);
+    const existing = await findWorkspaceRoot(o.cwd);
+    if (existing) {
+        if (path.resolve(existing) !== path.resolve(o.cwd))
+            notes.push(`Using the existing workspace root (${path.relative(o.cwd, existing) || '.'}).`);
+        return existing;
+    }
+    const top = await gitTopLevel(o.cwd);
+    if (top && path.resolve(top).toLowerCase() !== path.resolve(o.cwd).toLowerCase()) {
+        notes.push('Current directory is inside a Git repository; using the repository root. Pass --root to choose a different directory.');
+        return path.resolve(top);
+    }
+    return path.resolve(o.cwd);
+}
+/** Make sure each required line is present in .devworkspace/.gitignore without removing anything the user added. */
+async function ensureGitignore(ws) {
+    if (!(await pathExists(ws.gitignore))) {
+        await atomicWriteFile(ws.gitignore, LOCAL_GITIGNORE);
+        return 'created';
+    }
+    const text = await fs.readFile(ws.gitignore, 'utf8');
+    const have = new Set(text.split(/\r?\n/).map((l) => l.trim()));
+    const missing = LOCAL_GITIGNORE.split('\n').filter((l) => l && !l.startsWith('#') && !have.has(l));
+    if (missing.length === 0)
+        return 'unchanged';
+    const eol = text.includes('\r\n') ? '\r\n' : '\n';
+    await atomicWriteFile(ws.gitignore, text + (text.endsWith('\n') ? '' : eol) + missing.join(eol) + eol);
+    return 'updated';
+}
+export async function initWorkspace(o) {
+    const notes = [];
+    const root = await resolveRoot(o, notes);
+    const st = await fs.stat(root).catch(() => null);
+    if (!st?.isDirectory()) {
+        throw new DevWorkspaceError('NOT_FOUND', `Project root does not exist: ${root}`, { hint: 'Run the command inside your project, or pass --root <dir>.' });
+    }
+    const ws = wsPaths(root);
+    const created = [];
+    const unchanged = [];
+    const rel = (p) => path.relative(root, p).replace(/\\/g, '/');
+    const alreadyInitialized = await pathExists(ws.projectJson);
+    const dirs = [ws.contextDir, ws.decisionsDir, ws.tasksActive, ws.tasksCompleted, ws.sessionsDir, ws.analysisDir, ws.stateDir];
+    const pkg = (await pathExists(path.join(root, 'package.json'))) ? await readPackageJson(root, 'package.json').catch(() => null) : null;
+    const name = pkg?.name ?? path.basename(root);
+    const now = isoNow(o);
+    const integrations = await detectIntegrations(integrationCtx(o, root));
+    const result = (extra) => ({
+        root,
+        dryRun: !!o.dryRun,
+        alreadyInitialized,
+        created,
+        unchanged,
+        gitignoreUpdated: false,
+        notes,
+        integrations,
+        nextSteps: ['Run: devworkspace analyze', 'Then paste .devworkspace/analysis/onboarding-prompt.md into Claude Code'],
+        ...extra,
+    });
+    if (o.dryRun) {
+        for (const d of dirs)
+            if (!(await pathExists(d)))
+                created.push(rel(d) + '/');
+        if (!alreadyInitialized)
+            created.push(rel(ws.projectJson));
+        if (!(await pathExists(ws.gitignore)))
+            created.push(rel(ws.gitignore));
+        return result({});
+    }
+    await ensureDir(ws.dir);
+    return withLock(ws.dir, async () => {
+        for (const d of dirs) {
+            if (await pathExists(d))
+                unchanged.push(rel(d) + '/');
+            else {
+                await ensureDir(d);
+                created.push(rel(d) + '/');
+            }
+        }
+        // Empty directories do not survive Git, so keep portable folders alive.
+        for (const d of [ws.decisionsDir, ws.tasksActive, ws.tasksCompleted, ws.sessionsDir]) {
+            const keep = path.join(d, '.gitkeep');
+            if (!(await pathExists(keep)))
+                await fs.writeFile(keep, '');
+        }
+        let project;
+        if (alreadyInitialized) {
+            project = await loadProject(ws);
+            unchanged.push(rel(ws.projectJson));
+            if (project.devworkspaceVersion !== packageVersion()) {
+                project = { ...project, devworkspaceVersion: packageVersion(), updatedAt: now };
+                await atomicWriteJson(ws.projectJson, validateProject(project));
+                notes.push(`Recorded DevWorkspace ${packageVersion()} in project.json.`);
+            }
+        }
+        else {
+            project = {
+                schemaVersion: SCHEMA_VERSION,
+                projectId: newProjectId(),
+                name,
+                createdAt: now,
+                updatedAt: now,
+                devworkspaceVersion: packageVersion(),
+                settings: { review: 'light', maxFiles: 50_000 },
+                managedFiles: [{ path: `${WORKSPACE_DIR}/.gitignore`, mode: 'owned' }],
+            };
+            await atomicWriteJson(ws.projectJson, validateProject(project));
+            created.push(rel(ws.projectJson));
+        }
+        const gi = await ensureGitignore(ws);
+        if (gi === 'created')
+            created.push(rel(ws.gitignore));
+        else if (gi === 'updated')
+            notes.push('Added missing ignore rules to .devworkspace/.gitignore.');
+        else
+            unchanged.push(rel(ws.gitignore));
+        await atomicWriteJson(ws.integrationsState, { schemaVersion: SCHEMA_VERSION, detectedAt: now, integrations });
+        return result({ gitignoreUpdated: gi === 'updated' });
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/services/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/services/init.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { SCHEMA_VERSION, validateProject, type ProjectConfig } from '../config/schemas.js';\nimport { DevWorkspaceError } from '../errors/index.js';\nimport { gitTopLevel } from '../git/git.js';\nimport { detectIntegrations } from '../integrations/index.js';\nimport { atomicWriteFile, atomicWriteJson, ensureDir, pathExists } from '../utils/fs.js';\nimport { findWorkspaceRoot, LOCAL_GITIGNORE, loadProject, wsPaths, WORKSPACE_DIR, type Ws } from '../core/workspace.js';\nimport { packageVersion } from '../core/version.js';\nimport { withLock } from '../utils/lock.js';\nimport { readPackageJson } from '../discovery/detect.js';\nimport { newProjectId } from './analysis.js';\nimport { integrationCtx, isoNow, type ServiceOptions } from './common.js';\n\nexport interface InitOptions extends ServiceOptions {\n  /** Explicit project root; defaults to the Git top-level or the current directory. */\n  root?: string;\n}\n\nexport interface InitResult {\n  root: string;\n  dryRun: boolean;\n  alreadyInitialized: boolean;\n  created: string[];\n  unchanged: string[];\n  gitignoreUpdated: boolean;\n  notes: string[];\n  integrations: Awaited<ReturnType<typeof detectIntegrations>>;\n  nextSteps: string[];\n}\n\nasync function resolveRoot(o: InitOptions, notes: string[]): Promise<string> {\n  if (o.root) return path.resolve(o.cwd, o.root);\n  const existing = await findWorkspaceRoot(o.cwd);\n  if (existing) {\n    if (path.resolve(existing) !== path.resolve(o.cwd)) notes.push(`Using the existing workspace root (${path.relative(o.cwd, existing) || '.'}).`);\n    return existing;\n  }\n  const top = await gitTopLevel(o.cwd);\n  if (top && path.resolve(top).toLowerCase() !== path.resolve(o.cwd).toLowerCase()) {\n    notes.push('Current directory is inside a Git repository; using the repository root. Pass --root to choose a different directory.');\n    return path.resolve(top);\n  }\n  return path.resolve(o.cwd);\n}\n\n/** Make sure each required line is present in .devworkspace/.gitignore without removing anything the user added. */\nasync function ensureGitignore(ws: Ws): Promise<'created' | 'updated' | 'unchanged'> {\n  if (!(await pathExists(ws.gitignore))) {\n    await atomicWriteFile(ws.gitignore, LOCAL_GITIGNORE);\n    return 'created';\n  }\n  const text = await fs.readFile(ws.gitignore, 'utf8');\n  const have = new Set(text.split(/\\r?\\n/).map((l) => l.trim()));\n  const missing = LOCAL_GITIGNORE.split('\\n').filter((l) => l && !l.startsWith('#') && !have.has(l));\n  if (missing.length === 0) return 'unchanged';\n  const eol = text.includes('\\r\\n') ? '\\r\\n' : '\\n';\n  await atomicWriteFile(ws.gitignore, text + (text.endsWith('\\n') ? '' : eol) + missing.join(eol) + eol);\n  return 'updated';\n}\n\nexport async function initWorkspace(o: InitOptions): Promise<InitResult> {\n  const notes: string[] = [];\n  const root = await resolveRoot(o, notes);\n  const st = await fs.stat(root).catch(() => null);\n  if (!st?.isDirectory()) {\n    throw new DevWorkspaceError('NOT_FOUND', `Project root does not exist: ${root}`, { hint: 'Run the command inside your project, or pass --root <dir>.' });\n  }\n  const ws = wsPaths(root);\n  const created: string[] = [];\n  const unchanged: string[] = [];\n  const rel = (p: string): string => path.relative(root, p).replace(/\\\\/g, '/');\n  const alreadyInitialized = await pathExists(ws.projectJson);\n\n  const dirs = [ws.contextDir, ws.decisionsDir, ws.tasksActive, ws.tasksCompleted, ws.sessionsDir, ws.analysisDir, ws.stateDir];\n  const pkg = (await pathExists(path.join(root, 'package.json'))) ? await readPackageJson(root, 'package.json').catch(() => null) : null;\n  const name = pkg?.name ?? path.basename(root);\n  const now = isoNow(o);\n\n  const integrations = await detectIntegrations(integrationCtx(o, root));\n\n  const result = (extra: Partial<InitResult>): InitResult => ({\n    root,\n    dryRun: !!o.dryRun,\n    alreadyInitialized,\n    created,\n    unchanged,\n    gitignoreUpdated: false,\n    notes,\n    integrations,\n    nextSteps: ['Run: devworkspace analyze', 'Then paste .devworkspace/analysis/onboarding-prompt.md into Claude Code'],\n    ...extra,\n  });\n\n  if (o.dryRun) {\n    for (const d of dirs) if (!(await pathExists(d))) created.push(rel(d) + '/');\n    if (!alreadyInitialized) created.push(rel(ws.projectJson));\n    if (!(await pathExists(ws.gitignore))) created.push(rel(ws.gitignore));\n    return result({});\n  }\n\n  await ensureDir(ws.dir);\n  return withLock(ws.dir, async () => {\n    for (const d of dirs) {\n      if (await pathExists(d)) unchanged.push(rel(d) + '/');\n      else {\n        await ensureDir(d);\n        created.push(rel(d) + '/');\n      }\n    }\n    // Empty directories do not survive Git, so keep portable folders alive.\n    for (const d of [ws.decisionsDir, ws.tasksActive, ws.tasksCompleted, ws.sessionsDir]) {\n      const keep = path.join(d, '.gitkeep');\n      if (!(await pathExists(keep))) await fs.writeFile(keep, '');\n    }\n\n    let project: ProjectConfig;\n    if (alreadyInitialized) {\n      project = await loadProject(ws);\n      unchanged.push(rel(ws.projectJson));\n      if (project.devworkspaceVersion !== packageVersion()) {\n        project = { ...project, devworkspaceVersion: packageVersion(), updatedAt: now };\n        await atomicWriteJson(ws.projectJson, validateProject(project));\n        notes.push(`Recorded DevWorkspace ${packageVersion()} in project.json.`);\n      }\n    } else {\n      project = {\n        schemaVersion: SCHEMA_VERSION,\n        projectId: newProjectId(),\n        name,\n        createdAt: now,\n        updatedAt: now,\n        devworkspaceVersion: packageVersion(),\n        settings: { review: 'light', maxFiles: 50_000 },\n        managedFiles: [{ path: `${WORKSPACE_DIR}/.gitignore`, mode: 'owned' }],\n      };\n      await atomicWriteJson(ws.projectJson, validateProject(project));\n      created.push(rel(ws.projectJson));\n    }\n\n    const gi = await ensureGitignore(ws);\n    if (gi === 'created') created.push(rel(ws.gitignore));\n    else if (gi === 'updated') notes.push('Added missing ignore rules to .devworkspace/.gitignore.');\n    else unchanged.push(rel(ws.gitignore));\n\n    await atomicWriteJson(ws.integrationsState, { schemaVersion: SCHEMA_VERSION, detectedAt: now, integrations });\n    return result({ gitignoreUpdated: gi === 'updated' });\n  });\n}\n"]}

package/dist/services/knowledge.d.ts

@@ -0,0 +1,40 @@
+import { type CommandEntry, type Fact } from '../config/schemas.js';
+import { type FactInput } from '../knowledge/facts.js';
+import { type ServiceOptions } from './common.js';
+export declare function addFact(o: ServiceOptions, input: FactInput): Promise<{
+    fact: Fact;
+    action: string;
+}>;
+export declare function verifyFactByKey(o: ServiceOptions, key: string): Promise<Fact>;
+export declare function removeFactByKey(o: ServiceOptions, key: string): Promise<boolean>;
+export interface ContextResult {
+    project: {
+        name: string;
+        id: string;
+    };
+    topic: string | null;
+    facts: Fact[];
+    totalFacts: number;
+    testingContract: CommandEntry[];
+    decisions: {
+        number: number;
+        title: string;
+        status: string;
+        file: string;
+    }[];
+    activeTasks: {
+        id: string;
+        title: string;
+        status: string;
+    }[];
+    documents: {
+        name: string;
+        bytes: number;
+    }[];
+    content?: Record<string, string>;
+}
+/** What DevWorkspace currently believes about the project. Concise by default; --full adds the context documents. */
+export declare function getContext(o: ServiceOptions, opts?: {
+    topic?: string;
+    full?: boolean;
+}): Promise<ContextResult>;

package/dist/services/knowledge.js

@@ -0,0 +1,72 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { SCHEMA_VERSION, validateCommands } from '../config/schemas.js';
+import { loadProject, requireWorkspace } from '../core/workspace.js';
+import { readVersioned } from '../core/versioned.js';
+import { listDecisions } from '../decisions/decision.js';
+import { buildFact, loadFacts, removeFact, saveFacts, upsertFact, verifyFact } from '../knowledge/facts.js';
+import { listTasks } from '../tasks/task.js';
+import { pathExists, readTextBounded } from '../utils/fs.js';
+import { isoNow, mutate } from './common.js';
+export async function addFact(o, input) {
+    return mutate(o, async (ws) => {
+        const facts = await loadFacts(ws);
+        const existing = facts.facts.find((f) => f.key === input.key);
+        const fact = await buildFact(ws.root, input, isoNow(o), existing);
+        const action = upsertFact(facts, fact);
+        await saveFacts(ws, facts);
+        return { fact, action };
+    });
+}
+export async function verifyFactByKey(o, key) {
+    return mutate(o, async (ws) => {
+        const facts = await loadFacts(ws);
+        const fact = await verifyFact(ws.root, facts, key, isoNow(o));
+        await saveFacts(ws, facts);
+        return fact;
+    });
+}
+export async function removeFactByKey(o, key) {
+    return mutate(o, async (ws) => {
+        const facts = await loadFacts(ws);
+        const removed = removeFact(facts, key);
+        if (removed)
+            await saveFacts(ws, facts);
+        return removed;
+    });
+}
+/** What DevWorkspace currently believes about the project. Concise by default; --full adds the context documents. */
+export async function getContext(o, opts = {}) {
+    const ws = await requireWorkspace(o.cwd);
+    const project = await loadProject(ws);
+    const all = await loadFacts(ws);
+    const topic = opts.topic?.toLowerCase() ?? null;
+    const facts = topic ? all.facts.filter((f) => f.key.startsWith(topic) || f.key.includes(topic)) : all.facts;
+    let testingContract = [];
+    if (await pathExists(ws.commands))
+        testingContract = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data.checks;
+    const { decisions } = await listDecisions(ws);
+    const { tasks } = await listTasks(ws);
+    const documents = [];
+    const content = {};
+    if (await pathExists(ws.contextDir)) {
+        for (const name of (await fs.readdir(ws.contextDir)).filter((n) => n.endsWith('.md')).sort()) {
+            const full = path.join(ws.contextDir, name);
+            documents.push({ name, bytes: (await fs.stat(full)).size });
+            if (opts.full)
+                content[name] = (await readTextBounded(full, 256 * 1024)) ?? '';
+        }
+    }
+    return {
+        project: { name: project.name, id: project.projectId },
+        topic,
+        facts,
+        totalFacts: all.facts.length,
+        testingContract,
+        decisions: decisions.map((d) => ({ number: d.number, title: d.title, status: d.status, file: d.file })),
+        activeTasks: tasks.map((t) => ({ id: t.id, title: t.title, status: t.status })),
+        documents,
+        ...(opts.full ? { content } : {}),
+    };
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/services/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/services/knowledge.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { SCHEMA_VERSION, validateCommands, type CommandEntry, type Fact } from '../config/schemas.js';\nimport { loadProject, requireWorkspace } from '../core/workspace.js';\nimport { readVersioned } from '../core/versioned.js';\nimport { listDecisions } from '../decisions/decision.js';\nimport { buildFact, loadFacts, removeFact, saveFacts, upsertFact, verifyFact, type FactInput } from '../knowledge/facts.js';\nimport { listTasks } from '../tasks/task.js';\nimport { pathExists, readTextBounded } from '../utils/fs.js';\nimport { isoNow, mutate, type ServiceOptions } from './common.js';\n\nexport async function addFact(o: ServiceOptions, input: FactInput): Promise<{ fact: Fact; action: string }> {\n  return mutate(o, async (ws) => {\n    const facts = await loadFacts(ws);\n    const existing = facts.facts.find((f) => f.key === input.key);\n    const fact = await buildFact(ws.root, input, isoNow(o), existing);\n    const action = upsertFact(facts, fact);\n    await saveFacts(ws, facts);\n    return { fact, action };\n  });\n}\n\nexport async function verifyFactByKey(o: ServiceOptions, key: string): Promise<Fact> {\n  return mutate(o, async (ws) => {\n    const facts = await loadFacts(ws);\n    const fact = await verifyFact(ws.root, facts, key, isoNow(o));\n    await saveFacts(ws, facts);\n    return fact;\n  });\n}\n\nexport async function removeFactByKey(o: ServiceOptions, key: string): Promise<boolean> {\n  return mutate(o, async (ws) => {\n    const facts = await loadFacts(ws);\n    const removed = removeFact(facts, key);\n    if (removed) await saveFacts(ws, facts);\n    return removed;\n  });\n}\n\nexport interface ContextResult {\n  project: { name: string; id: string };\n  topic: string | null;\n  facts: Fact[];\n  totalFacts: number;\n  testingContract: CommandEntry[];\n  decisions: { number: number; title: string; status: string; file: string }[];\n  activeTasks: { id: string; title: string; status: string }[];\n  documents: { name: string; bytes: number }[];\n  content?: Record<string, string>;\n}\n\n/** What DevWorkspace currently believes about the project. Concise by default; --full adds the context documents. */\nexport async function getContext(o: ServiceOptions, opts: { topic?: string; full?: boolean } = {}): Promise<ContextResult> {\n  const ws = await requireWorkspace(o.cwd);\n  const project = await loadProject(ws);\n  const all = await loadFacts(ws);\n  const topic = opts.topic?.toLowerCase() ?? null;\n  const facts = topic ? all.facts.filter((f) => f.key.startsWith(topic) || f.key.includes(topic)) : all.facts;\n  let testingContract: CommandEntry[] = [];\n  if (await pathExists(ws.commands)) testingContract = (await readVersioned(ws.commands, 'commands', SCHEMA_VERSION, validateCommands)).data.checks;\n  const { decisions } = await listDecisions(ws);\n  const { tasks } = await listTasks(ws);\n  const documents: { name: string; bytes: number }[] = [];\n  const content: Record<string, string> = {};\n  if (await pathExists(ws.contextDir)) {\n    for (const name of (await fs.readdir(ws.contextDir)).filter((n) => n.endsWith('.md')).sort()) {\n      const full = path.join(ws.contextDir, name);\n      documents.push({ name, bytes: (await fs.stat(full)).size });\n      if (opts.full) content[name] = (await readTextBounded(full, 256 * 1024)) ?? '';\n    }\n  }\n  return {\n    project: { name: project.name, id: project.projectId },\n    topic,\n    facts,\n    totalFacts: all.facts.length,\n    testingContract,\n    decisions: decisions.map((d) => ({ number: d.number, title: d.title, status: d.status, file: d.file })),\n    activeTasks: tasks.map((t) => ({ id: t.id, title: t.title, status: t.status })),\n    documents,\n    ...(opts.full ? { content } : {}),\n  };\n}\n"]}

package/dist/services/migrate.d.ts

@@ -0,0 +1,16 @@
+import { type Migration } from '../core/migrations.js';
+import { type ServiceOptions } from './common.js';
+export interface MigrateResult {
+    dryRun: boolean;
+    checked: number;
+    migrated: {
+        file: string;
+        from: number;
+        to: number;
+    }[];
+}
+/**
+ * Upgrade every schema-versioned file to the current schema. Each file is backed up under
+ * .devworkspace/local/backups/ before it is rewritten, and files from a newer schema abort the run untouched.
+ */
+export declare function migrateWorkspace(o: ServiceOptions, registry?: Record<string, Migration[]>, target?: number): Promise<MigrateResult>;

package/dist/services/migrate.js

@@ -0,0 +1,54 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { SCHEMA_VERSION, validateAnalysisState, validateCommands, validateFacts, validateProject } from '../config/schemas.js';
+import { MIGRATIONS, migrateData } from '../core/migrations.js';
+import { writeVersioned } from '../core/versioned.js';
+import { validateSession } from '../sessions/session.js';
+import { validateTask } from '../tasks/task.js';
+import { pathExists, readJsonFile } from '../utils/fs.js';
+import { mutate } from './common.js';
+async function jsonIn(dir) {
+    if (!(await pathExists(dir)))
+        return [];
+    return (await fs.readdir(dir)).filter((n) => n.endsWith('.json')).map((n) => path.join(dir, n));
+}
+/**
+ * Upgrade every schema-versioned file to the current schema. Each file is backed up under
+ * .devworkspace/local/backups/ before it is rewritten, and files from a newer schema abort the run untouched.
+ */
+export async function migrateWorkspace(o, registry = MIGRATIONS, target = SCHEMA_VERSION) {
+    return mutate(o, async (ws) => {
+        const targets = [
+            { file: ws.projectJson, kind: 'project', validate: validateProject },
+            { file: ws.facts, kind: 'facts', validate: validateFacts },
+            { file: ws.commands, kind: 'commands', validate: validateCommands },
+            { file: ws.analysisState, kind: 'analysis', validate: validateAnalysisState },
+            ...(await jsonIn(ws.tasksActive)).map((file) => ({ file, kind: 'task', validate: validateTask })),
+            ...(await jsonIn(ws.tasksCompleted)).map((file) => ({ file, kind: 'task', validate: validateTask })),
+            ...(await jsonIn(ws.sessionsDir)).map((file) => ({ file, kind: 'session', validate: validateSession })),
+        ];
+        // Plan first: nothing is written unless every file can be migrated.
+        const plan = [];
+        let checked = 0;
+        for (const t of targets) {
+            if (!(await pathExists(t.file)))
+                continue;
+            checked++;
+            const r = migrateData(await readJsonFile(t.file), target, registry[t.kind] ?? [], path.basename(t.file));
+            if (r.migrated) {
+                t.validate(r.data);
+                plan.push({ file: t.file, data: r.data, from: r.from });
+            }
+        }
+        const stamp = `migrate-${new Date().toISOString().replace(/[:.]/g, '-')}`;
+        if (!o.dryRun)
+            for (const p of plan)
+                await writeVersioned(ws, p.file, p.data, stamp);
+        return {
+            dryRun: !!o.dryRun,
+            checked,
+            migrated: plan.map((p) => ({ file: path.relative(ws.root, p.file).replace(/\\/g, '/'), from: p.from, to: target })),
+        };
+    });
+}
+//# sourceMappingURL=migrate.js.map

package/dist/services/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/services/migrate.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, validateFacts, validateProject } from '../config/schemas.js';\nimport { MIGRATIONS, migrateData, type Migration } from '../core/migrations.js';\nimport { writeVersioned } from '../core/versioned.js';\nimport { type Ws } from '../core/workspace.js';\nimport { validateSession } from '../sessions/session.js';\nimport { validateTask } from '../tasks/task.js';\nimport { pathExists, readJsonFile } from '../utils/fs.js';\nimport { mutate, type ServiceOptions } from './common.js';\n\nexport interface MigrateResult {\n  dryRun: boolean;\n  checked: number;\n  migrated: { file: string; from: number; to: number }[];\n}\n\ntype Validator = (v: unknown, file?: string) => unknown;\n\nasync function jsonIn(dir: string): Promise<string[]> {\n  if (!(await pathExists(dir))) return [];\n  return (await fs.readdir(dir)).filter((n) => n.endsWith('.json')).map((n) => path.join(dir, n));\n}\n\n/**\n * Upgrade every schema-versioned file to the current schema. Each file is backed up under\n * .devworkspace/local/backups/ before it is rewritten, and files from a newer schema abort the run untouched.\n */\nexport async function migrateWorkspace(o: ServiceOptions, registry: Record<string, Migration[]> = MIGRATIONS, target: number = SCHEMA_VERSION): Promise<MigrateResult> {\n  return mutate(o, async (ws: Ws) => {\n    const targets: { file: string; kind: string; validate: Validator }[] = [\n      { file: ws.projectJson, kind: 'project', validate: validateProject },\n      { file: ws.facts, kind: 'facts', validate: validateFacts },\n      { file: ws.commands, kind: 'commands', validate: validateCommands },\n      { file: ws.analysisState, kind: 'analysis', validate: validateAnalysisState },\n      ...(await jsonIn(ws.tasksActive)).map((file) => ({ file, kind: 'task', validate: validateTask as Validator })),\n      ...(await jsonIn(ws.tasksCompleted)).map((file) => ({ file, kind: 'task', validate: validateTask as Validator })),\n      ...(await jsonIn(ws.sessionsDir)).map((file) => ({ file, kind: 'session', validate: validateSession as Validator })),\n    ];\n    // Plan first: nothing is written unless every file can be migrated.\n    const plan: { file: string; data: { schemaVersion: number }; from: number }[] = [];\n    let checked = 0;\n    for (const t of targets) {\n      if (!(await pathExists(t.file))) continue;\n      checked++;\n      const r = migrateData(await readJsonFile(t.file), target, registry[t.kind] ?? [], path.basename(t.file));\n      if (r.migrated) {\n        t.validate(r.data);\n        plan.push({ file: t.file, data: r.data as { schemaVersion: number }, from: r.from });\n      }\n    }\n    const stamp = `migrate-${new Date().toISOString().replace(/[:.]/g, '-')}`;\n    if (!o.dryRun) for (const p of plan) await writeVersioned(ws, p.file, p.data, stamp);\n    return {\n      dryRun: !!o.dryRun,\n      checked,\n      migrated: plan.map((p) => ({ file: path.relative(ws.root, p.file).replace(/\\\\/g, '/'), from: p.from, to: target })),\n    };\n  });\n}\n"]}

package/dist/services/portability.d.ts

@@ -0,0 +1,27 @@
+import { type Ws } from '../core/workspace.js';
+import { type ServiceOptions } from './common.js';
+export interface ExportResult {
+    file: string | null;
+    dryRun: boolean;
+    fileCount: number;
+    bytes: number;
+    files: string[];
+}
+export declare function exportWorkspace(o: ServiceOptions, outPath?: string): Promise<ExportResult>;
+export interface ImportResult {
+    dryRun: boolean;
+    created: string[];
+    updated: string[];
+    unchanged: string[];
+    merged: string[];
+    conflicts: {
+        path: string;
+        reason: string;
+    }[];
+}
+export interface ImportOptions extends ServiceOptions {
+    overwrite?: boolean;
+    allowDifferentProject?: boolean;
+}
+export declare function importWorkspace(o: ImportOptions, file: string): Promise<ImportResult>;
+export type { Ws };

package/dist/services/portability.js

@@ -0,0 +1,155 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { SCHEMA_VERSION, validateFacts } from '../config/schemas.js';
+import { DevWorkspaceError } from '../errors/index.js';
+import { loadProject, requireWorkspace } from '../core/workspace.js';
+import { packageVersion } from '../core/version.js';
+import { authorityRank } from '../knowledge/facts.js';
+import { BUNDLE_FORMAT, MAX_BUNDLE_BYTES, isExportable, parseBundle } from '../portability/bundle.js';
+import { findSecrets } from '../security/redact.js';
+import { atomicWriteFile, ensureDir, listFilesRecursive, pathExists, writeTextIfChanged } from '../utils/fs.js';
+import { assertNoSymlinkEscape, resolveInside, toPosix } from '../utils/paths.js';
+import { withLock } from '../utils/lock.js';
+import { isoNow } from './common.js';
+export async function exportWorkspace(o, outPath) {
+    const ws = await requireWorkspace(o.cwd);
+    const project = await loadProject(ws);
+    const files = {};
+    let bytes = 0;
+    for (const abs of await listFilesRecursive(ws.dir, 5000)) {
+        const rel = toPosix(path.relative(ws.dir, abs));
+        if (!isExportable(rel))
+            continue;
+        const text = await fs.readFile(abs, 'utf8');
+        if (findSecrets(text).length > 0) {
+            throw new DevWorkspaceError('SECURITY', `Refusing to export: ${rel} contains secret-like values.`, {
+                hint: 'Remove the value (and rotate the credential if it was real), then export again.',
+            });
+        }
+        files[rel] = text;
+        bytes += text.length;
+        if (bytes > MAX_BUNDLE_BYTES)
+            throw new DevWorkspaceError('SECURITY', 'Workspace is too large to export.');
+    }
+    const names = Object.keys(files).sort();
+    if (o.dryRun)
+        return { file: null, dryRun: true, fileCount: names.length, bytes, files: names };
+    const target = path.resolve(o.cwd, outPath ?? `devworkspace-export-${isoNow(o).slice(0, 10)}.json`);
+    const insideWorkspace = !path.relative(ws.dir, target).startsWith('..') && !path.isAbsolute(path.relative(ws.dir, target));
+    if (insideWorkspace)
+        throw new DevWorkspaceError('USAGE', 'Choose an export location outside .devworkspace/.');
+    const bundle = {
+        format: BUNDLE_FORMAT,
+        schemaVersion: SCHEMA_VERSION,
+        exportedAt: isoNow(o),
+        devworkspaceVersion: packageVersion(),
+        projectId: project.projectId,
+        projectName: project.name,
+        files: Object.fromEntries(names.map((n) => [n, files[n]])),
+    };
+    await atomicWriteFile(target, JSON.stringify(bundle, null, 2) + '\n');
+    return { file: target, dryRun: false, fileCount: names.length, bytes, files: names };
+}
+function mergeFacts(local, incoming) {
+    const out = { schemaVersion: SCHEMA_VERSION, facts: [...local.facts] };
+    let changed = 0;
+    for (const inc of incoming.facts) {
+        const i = out.facts.findIndex((f) => f.key === inc.key);
+        if (i === -1) {
+            out.facts.push(inc);
+            changed++;
+            continue;
+        }
+        const cur = out.facts[i];
+        const incomingWins = inc.updatedAt > cur.updatedAt && (authorityRank(inc) >= authorityRank(cur) || cur.status === 'STALE');
+        if (incomingWins && JSON.stringify(inc) !== JSON.stringify(cur)) {
+            out.facts[i] = inc;
+            changed++;
+        }
+    }
+    out.facts.sort((a, b) => a.key.localeCompare(b.key));
+    return { merged: out, changed };
+}
+export async function importWorkspace(o, file) {
+    const ws = await requireWorkspace(o.cwd);
+    const abs = path.resolve(o.cwd, file);
+    const stat = await fs.stat(abs).catch(() => null);
+    if (!stat?.isFile())
+        throw new DevWorkspaceError('NOT_FOUND', `Import file not found: ${file}`);
+    if (stat.size > MAX_BUNDLE_BYTES)
+        throw new DevWorkspaceError('SECURITY', 'Import file is too large.');
+    const bundle = parseBundle(await fs.readFile(abs, 'utf8')); // validates everything before any write
+    const project = await loadProject(ws);
+    if (bundle.projectId !== project.projectId && !o.allowDifferentProject) {
+        throw new DevWorkspaceError('CONFLICT', 'This export belongs to a different project (projectId differs).', {
+            hint: 'If you are sure, re-run with --allow-different-project.',
+        });
+    }
+    const result = { dryRun: !!o.dryRun, created: [], updated: [], unchanged: [], merged: [], conflicts: [] };
+    const apply = async () => {
+        for (const rel of Object.keys(bundle.files).sort()) {
+            const content = bundle.files[rel];
+            if (rel === 'project.json') {
+                result.unchanged.push(rel); // local identity is never replaced by an import
+                continue;
+            }
+            const target = resolveInside(ws.dir, rel);
+            await assertNoSymlinkEscape(ws.dir, target);
+            const exists = await pathExists(target);
+            if (!exists) {
+                if (!o.dryRun) {
+                    await ensureDir(path.dirname(target));
+                    await atomicWriteFile(target, content);
+                }
+                result.created.push(rel);
+                continue;
+            }
+            const local = await fs.readFile(target, 'utf8');
+            if (local === content) {
+                result.unchanged.push(rel);
+                continue;
+            }
+            if (rel === 'context/facts.json') {
+                const { merged, changed } = mergeFacts(validateFacts(JSON.parse(local)), validateFacts(JSON.parse(content)));
+                if (changed > 0) {
+                    if (!o.dryRun)
+                        await writeTextIfChanged(target, JSON.stringify(merged, null, 2) + '\n');
+                    result.merged.push(`${rel} (${changed} fact(s))`);
+                }
+                else
+                    result.unchanged.push(rel);
+                continue;
+            }
+            if (rel.startsWith('tasks/')) {
+                const l = JSON.parse(local);
+                const i = JSON.parse(content);
+                if ((i.updatedAt ?? '') > (l.updatedAt ?? '')) {
+                    if (!o.dryRun)
+                        await atomicWriteFile(target, content);
+                    result.updated.push(rel);
+                }
+                else
+                    result.conflicts.push({ path: rel, reason: 'local task is newer or equal; kept local' });
+                continue;
+            }
+            if (o.overwrite) {
+                if (!o.dryRun) {
+                    const backup = path.join(ws.backupsDir, `import-${isoNow(o).replace(/[:.]/g, '-')}`, rel);
+                    await ensureDir(path.dirname(backup));
+                    await fs.copyFile(target, backup);
+                    await atomicWriteFile(target, content);
+                }
+                result.updated.push(rel);
+            }
+            else {
+                result.conflicts.push({ path: rel, reason: 'differs from the local file; kept local (use --overwrite to replace, a backup is kept)' });
+            }
+        }
+    };
+    if (o.dryRun)
+        await apply();
+    else
+        await withLock(ws.dir, apply);
+    return result;
+}
+//# sourceMappingURL=portability.js.map

package/dist/services/portability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability.js","sourceRoot":"","sources":["../../src/services/portability.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { SCHEMA_VERSION, validateFacts, type Fact, type FactsFile } from '../config/schemas.js';\nimport { DevWorkspaceError } from '../errors/index.js';\nimport { loadProject, requireWorkspace, type Ws } from '../core/workspace.js';\nimport { packageVersion } from '../core/version.js';\nimport { authorityRank } from '../knowledge/facts.js';\nimport { BUNDLE_FORMAT, MAX_BUNDLE_BYTES, isExportable, parseBundle, type Bundle } from '../portability/bundle.js';\nimport { findSecrets } from '../security/redact.js';\nimport { atomicWriteFile, ensureDir, listFilesRecursive, pathExists, writeTextIfChanged } from '../utils/fs.js';\nimport { assertNoSymlinkEscape, resolveInside, toPosix } from '../utils/paths.js';\nimport { withLock } from '../utils/lock.js';\nimport { isoNow, type ServiceOptions } from './common.js';\n\nexport interface ExportResult {\n  file: string | null;\n  dryRun: boolean;\n  fileCount: number;\n  bytes: number;\n  files: string[];\n}\n\nexport async function exportWorkspace(o: ServiceOptions, outPath?: string): Promise<ExportResult> {\n  const ws = await requireWorkspace(o.cwd);\n  const project = await loadProject(ws);\n  const files: Record<string, string> = {};\n  let bytes = 0;\n  for (const abs of await listFilesRecursive(ws.dir, 5000)) {\n    const rel = toPosix(path.relative(ws.dir, abs));\n    if (!isExportable(rel)) continue;\n    const text = await fs.readFile(abs, 'utf8');\n    if (findSecrets(text).length > 0) {\n      throw new DevWorkspaceError('SECURITY', `Refusing to export: ${rel} contains secret-like values.`, {\n        hint: 'Remove the value (and rotate the credential if it was real), then export again.',\n      });\n    }\n    files[rel] = text;\n    bytes += text.length;\n    if (bytes > MAX_BUNDLE_BYTES) throw new DevWorkspaceError('SECURITY', 'Workspace is too large to export.');\n  }\n  const names = Object.keys(files).sort();\n  if (o.dryRun) return { file: null, dryRun: true, fileCount: names.length, bytes, files: names };\n\n  const target = path.resolve(o.cwd, outPath ?? `devworkspace-export-${isoNow(o).slice(0, 10)}.json`);\n  const insideWorkspace = !path.relative(ws.dir, target).startsWith('..') && !path.isAbsolute(path.relative(ws.dir, target));\n  if (insideWorkspace) throw new DevWorkspaceError('USAGE', 'Choose an export location outside .devworkspace/.');\n  const bundle: Bundle = {\n    format: BUNDLE_FORMAT,\n    schemaVersion: SCHEMA_VERSION,\n    exportedAt: isoNow(o),\n    devworkspaceVersion: packageVersion(),\n    projectId: project.projectId,\n    projectName: project.name,\n    files: Object.fromEntries(names.map((n) => [n, files[n]!])),\n  };\n  await atomicWriteFile(target, JSON.stringify(bundle, null, 2) + '\\n');\n  return { file: target, dryRun: false, fileCount: names.length, bytes, files: names };\n}\n\nexport interface ImportResult {\n  dryRun: boolean;\n  created: string[];\n  updated: string[];\n  unchanged: string[];\n  merged: string[];\n  conflicts: { path: string; reason: string }[];\n}\n\nexport interface ImportOptions extends ServiceOptions {\n  overwrite?: boolean;\n  allowDifferentProject?: boolean;\n}\n\nfunction mergeFacts(local: FactsFile, incoming: FactsFile): { merged: FactsFile; changed: number } {\n  const out: FactsFile = { schemaVersion: SCHEMA_VERSION, facts: [...local.facts] };\n  let changed = 0;\n  for (const inc of incoming.facts) {\n    const i = out.facts.findIndex((f) => f.key === inc.key);\n    if (i === -1) {\n      out.facts.push(inc);\n      changed++;\n      continue;\n    }\n    const cur = out.facts[i]!;\n    const incomingWins = inc.updatedAt > cur.updatedAt && (authorityRank(inc) >= authorityRank(cur) || cur.status === 'STALE');\n    if (incomingWins && JSON.stringify(inc) !== JSON.stringify(cur)) {\n      out.facts[i] = inc as Fact;\n      changed++;\n    }\n  }\n  out.facts.sort((a, b) => a.key.localeCompare(b.key));\n  return { merged: out, changed };\n}\n\nexport async function importWorkspace(o: ImportOptions, file: string): Promise<ImportResult> {\n  const ws = await requireWorkspace(o.cwd);\n  const abs = path.resolve(o.cwd, file);\n  const stat = await fs.stat(abs).catch(() => null);\n  if (!stat?.isFile()) throw new DevWorkspaceError('NOT_FOUND', `Import file not found: ${file}`);\n  if (stat.size > MAX_BUNDLE_BYTES) throw new DevWorkspaceError('SECURITY', 'Import file is too large.');\n  const bundle = parseBundle(await fs.readFile(abs, 'utf8')); // validates everything before any write\n  const project = await loadProject(ws);\n  if (bundle.projectId !== project.projectId && !o.allowDifferentProject) {\n    throw new DevWorkspaceError('CONFLICT', 'This export belongs to a different project (projectId differs).', {\n      hint: 'If you are sure, re-run with --allow-different-project.',\n    });\n  }\n\n  const result: ImportResult = { dryRun: !!o.dryRun, created: [], updated: [], unchanged: [], merged: [], conflicts: [] };\n  const apply = async (): Promise<void> => {\n    for (const rel of Object.keys(bundle.files).sort()) {\n      const content = bundle.files[rel]!;\n      if (rel === 'project.json') {\n        result.unchanged.push(rel); // local identity is never replaced by an import\n        continue;\n      }\n      const target = resolveInside(ws.dir, rel);\n      await assertNoSymlinkEscape(ws.dir, target);\n      const exists = await pathExists(target);\n      if (!exists) {\n        if (!o.dryRun) {\n          await ensureDir(path.dirname(target));\n          await atomicWriteFile(target, content);\n        }\n        result.created.push(rel);\n        continue;\n      }\n      const local = await fs.readFile(target, 'utf8');\n      if (local === content) {\n        result.unchanged.push(rel);\n        continue;\n      }\n      if (rel === 'context/facts.json') {\n        const { merged, changed } = mergeFacts(validateFacts(JSON.parse(local)), validateFacts(JSON.parse(content)));\n        if (changed > 0) {\n          if (!o.dryRun) await writeTextIfChanged(target, JSON.stringify(merged, null, 2) + '\\n');\n          result.merged.push(`${rel} (${changed} fact(s))`);\n        } else result.unchanged.push(rel);\n        continue;\n      }\n      if (rel.startsWith('tasks/')) {\n        const l = JSON.parse(local) as { updatedAt?: string };\n        const i = JSON.parse(content) as { updatedAt?: string };\n        if ((i.updatedAt ?? '') > (l.updatedAt ?? '')) {\n          if (!o.dryRun) await atomicWriteFile(target, content);\n          result.updated.push(rel);\n        } else result.conflicts.push({ path: rel, reason: 'local task is newer or equal; kept local' });\n        continue;\n      }\n      if (o.overwrite) {\n        if (!o.dryRun) {\n          const backup = path.join(ws.backupsDir, `import-${isoNow(o).replace(/[:.]/g, '-')}`, rel);\n          await ensureDir(path.dirname(backup));\n          await fs.copyFile(target, backup);\n          await atomicWriteFile(target, content);\n        }\n        result.updated.push(rel);\n      } else {\n        result.conflicts.push({ path: rel, reason: 'differs from the local file; kept local (use --overwrite to replace, a backup is kept)' });\n      }\n    }\n  };\n  if (o.dryRun) await apply();\n  else await withLock(ws.dir, apply);\n  return result;\n}\n\nexport type { Ws };\n"]}

package/dist/services/records.d.ts

@@ -0,0 +1,8 @@
+import { type Decision, type DecisionInput } from '../decisions/decision.js';
+import { type Session, type SessionInput } from '../sessions/session.js';
+import { type ServiceOptions } from './common.js';
+export declare function recordDecision(o: ServiceOptions, input: DecisionInput): Promise<Decision>;
+export declare function getDecisions(o: ServiceOptions): Promise<Decision[]>;
+export declare function getDecision(o: ServiceOptions, number: number): Promise<Decision>;
+export declare function recordSession(o: ServiceOptions, input: SessionInput): Promise<Session>;
+export declare function getSessions(o: ServiceOptions, limit?: number): Promise<Session[]>;

package/dist/services/records.js

@@ -0,0 +1,26 @@
+import { requireWorkspace } from '../core/workspace.js';
+import { addDecision, listDecisions } from '../decisions/decision.js';
+import { listSessions, saveSession } from '../sessions/session.js';
+import { DevWorkspaceError } from '../errors/index.js';
+import { isoNow, mutate } from './common.js';
+export async function recordDecision(o, input) {
+    return mutate(o, (ws) => addDecision(ws, input, isoNow(o)));
+}
+export async function getDecisions(o) {
+    const ws = await requireWorkspace(o.cwd);
+    return (await listDecisions(ws)).decisions;
+}
+export async function getDecision(o, number) {
+    const d = (await getDecisions(o)).find((x) => x.number === number);
+    if (!d)
+        throw new DevWorkspaceError('NOT_FOUND', `No decision number ${number}.`);
+    return d;
+}
+export async function recordSession(o, input) {
+    return mutate(o, (ws) => saveSession(ws, input, isoNow(o)));
+}
+export async function getSessions(o, limit = 10) {
+    const ws = await requireWorkspace(o.cwd);
+    return listSessions(ws, limit);
+}
+//# sourceMappingURL=records.js.map