@dzhechkov/harness-core 0.3.10 → 0.3.11

package/dist/index.d.ts

@@ -18,6 +18,8 @@ export { benchmarkSkill, benchmarkSkills, compareSkills } from './benchmark.js';
 export { buildRegistry, searchRegistry, filterByCategory } from './registry.js';
 export { recommend } from './recommend.js';
 export { pretrain } from './pretrain.js';
+export { runSetup } from './setup.js';
+export type { SetupOptions, SetupResult, SetupStep } from './setup.js';
 export type { PretrainResult, DetectedTech } from './pretrain.js';
 export type { RecommendationReport, SkillRecommendation } from './recommend.js';
 export { discoverPackages, publishPackages } from './publish.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClH,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClH,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -16,6 +16,7 @@ export { benchmarkSkill, benchmarkSkills, compareSkills } from './benchmark.js';
 export { buildRegistry, searchRegistry, filterByCategory } from './registry.js';
 export { recommend } from './recommend.js';
 export { pretrain } from './pretrain.js';
+export { runSetup } from './setup.js';
 export { discoverPackages, publishPackages } from './publish.js';
 export { fetchAllDownloads } from './downloads.js';
 export { discoverInstalled, checkUpgrades } from './upgrade.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Full environment setup — skills + hooks + memory + pretrain.
+ *
+ * Unlike `dz init` (skills only), `dz setup` configures the complete
+ * self-learning environment:
+ * 1. Skills installation (via init)
+ * 2. Claude Code hooks (session-start/end for memory)
+ * 3. Memory database initialization (.dz/memory.db)
+ * 4. Pretrain (project analysis → auto-recommend)
+ *
+ * All operations are additive — never overwrites existing files.
+ *
+ * @packageDocumentation
+ */
+/** Setup options. */
+export interface SetupOptions {
+    readonly projectRoot: string;
+    readonly target: string;
+    readonly preset?: string | undefined;
+    readonly noHooks?: boolean | undefined;
+    readonly noMemory?: boolean | undefined;
+    readonly noPretrain?: boolean | undefined;
+    readonly force?: boolean | undefined;
+}
+/** Setup result. */
+export interface SetupResult {
+    readonly steps: readonly SetupStep[];
+    readonly totalSteps: number;
+    readonly completed: number;
+    readonly skipped: number;
+}
+/** A single setup step. */
+export interface SetupStep {
+    readonly name: string;
+    readonly status: 'done' | 'skipped' | 'error';
+    readonly detail: string;
+}
+/** Run full environment setup. */
+export declare function runSetup(opts: SetupOptions): SetupResult;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAED,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA2CD,kCAAkC;AAClC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CA0FxD"}

package/dist/setup.js

@@ -0,0 +1,150 @@
+/**
+ * Full environment setup — skills + hooks + memory + pretrain.
+ *
+ * Unlike `dz init` (skills only), `dz setup` configures the complete
+ * self-learning environment:
+ * 1. Skills installation (via init)
+ * 2. Claude Code hooks (session-start/end for memory)
+ * 3. Memory database initialization (.dz/memory.db)
+ * 4. Pretrain (project analysis → auto-recommend)
+ *
+ * All operations are additive — never overwrites existing files.
+ *
+ * @packageDocumentation
+ */
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Generate Claude Code hooks configuration for self-learning. */
+function generateHooksConfig(projectRoot) {
+    const dzDir = join(projectRoot, '.dz');
+    return JSON.stringify({
+        hooks: {
+            SessionStart: [{
+                    type: 'command',
+                    command: `node -e "const fs=require('fs');const p='${dzDir}/memory.db';const d=new Date().toISOString();fs.appendFileSync('${dzDir}/sessions.jsonl',JSON.stringify({event:'start',ts:d})+'\\n')"`,
+                }],
+            SessionEnd: [{
+                    type: 'command',
+                    command: `node -e "const fs=require('fs');const d=new Date().toISOString();fs.appendFileSync('${dzDir}/sessions.jsonl',JSON.stringify({event:'end',ts:d})+'\\n')"`,
+                }],
+        },
+    }, null, 2);
+}
+/** Generate .dz/config.json with learning settings. */
+function generateDzConfig(target, preset) {
+    return JSON.stringify({
+        version: '1.0.0',
+        target,
+        preset: preset ?? null,
+        learning: {
+            enabled: true,
+            sessionTracking: true,
+            patternConsolidation: true,
+            retentionDays: 90,
+        },
+        memory: {
+            backend: 'jsonl',
+            path: '.dz/sessions.jsonl',
+            maxSizeMb: 10,
+        },
+        hooks: {
+            sessionStart: true,
+            sessionEnd: true,
+        },
+    }, null, 2);
+}
+/** Run full environment setup. */
+export function runSetup(opts) {
+    const steps = [];
+    const dzDir = join(opts.projectRoot, '.dz');
+    // Step 1: Create .dz directory
+    if (!existsSync(dzDir)) {
+        mkdirSync(dzDir, { recursive: true });
+        steps.push({ name: 'Create .dz directory', status: 'done', detail: dzDir });
+    }
+    else {
+        steps.push({ name: 'Create .dz directory', status: 'skipped', detail: 'already exists' });
+    }
+    // Step 2: Write .dz/config.json
+    const configPath = join(dzDir, 'config.json');
+    if (!existsSync(configPath) || opts.force) {
+        writeFileSync(configPath, generateDzConfig(opts.target, opts.preset));
+        steps.push({ name: 'Write .dz/config.json', status: 'done', detail: 'learning + memory config' });
+    }
+    else {
+        steps.push({ name: 'Write .dz/config.json', status: 'skipped', detail: 'already exists (use --force)' });
+    }
+    // Step 3: Initialize session log
+    const sessionsPath = join(dzDir, 'sessions.jsonl');
+    if (!existsSync(sessionsPath)) {
+        writeFileSync(sessionsPath, '');
+        steps.push({ name: 'Initialize sessions.jsonl', status: 'done', detail: 'session tracking ready' });
+    }
+    else {
+        steps.push({ name: 'Initialize sessions.jsonl', status: 'skipped', detail: 'already exists' });
+    }
+    // Step 4: Initialize patterns store
+    const patternsPath = join(dzDir, 'patterns.jsonl');
+    if (!existsSync(patternsPath)) {
+        writeFileSync(patternsPath, '');
+        steps.push({ name: 'Initialize patterns.jsonl', status: 'done', detail: 'pattern learning ready' });
+    }
+    else {
+        steps.push({ name: 'Initialize patterns.jsonl', status: 'skipped', detail: 'already exists' });
+    }
+    // Step 5: Configure hooks (write to .claude/settings.json)
+    if (!opts.noHooks) {
+        const settingsDir = join(opts.projectRoot, '.claude');
+        const settingsPath = join(settingsDir, 'settings.json');
+        if (!existsSync(settingsPath) || opts.force) {
+            mkdirSync(settingsDir, { recursive: true });
+            writeFileSync(settingsPath, generateHooksConfig(opts.projectRoot));
+            steps.push({ name: 'Configure hooks', status: 'done', detail: 'session-start + session-end hooks' });
+        }
+        else {
+            // Merge hooks into existing settings
+            try {
+                const existing = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+                if (!existing['hooks']) {
+                    const hooks = JSON.parse(generateHooksConfig(opts.projectRoot));
+                    existing['hooks'] = hooks.hooks;
+                    writeFileSync(settingsPath, JSON.stringify(existing, null, 2));
+                    steps.push({ name: 'Configure hooks', status: 'done', detail: 'merged into existing settings' });
+                }
+                else {
+                    steps.push({ name: 'Configure hooks', status: 'skipped', detail: 'hooks already configured' });
+                }
+            }
+            catch {
+                steps.push({ name: 'Configure hooks', status: 'skipped', detail: 'could not parse existing settings' });
+            }
+        }
+    }
+    else {
+        steps.push({ name: 'Configure hooks', status: 'skipped', detail: '--no-hooks' });
+    }
+    // Step 6: Update .gitignore
+    const gitignorePath = join(opts.projectRoot, '.gitignore');
+    const dzIgnoreEntry = '\n# DZ Harness learning data\n.dz/sessions.jsonl\n.dz/patterns.jsonl\n';
+    if (existsSync(gitignorePath)) {
+        const content = readFileSync(gitignorePath, 'utf-8');
+        if (!content.includes('.dz/sessions.jsonl')) {
+            writeFileSync(gitignorePath, content + dzIgnoreEntry);
+            steps.push({ name: 'Update .gitignore', status: 'done', detail: 'added .dz/sessions.jsonl + patterns.jsonl' });
+        }
+        else {
+            steps.push({ name: 'Update .gitignore', status: 'skipped', detail: 'already ignoring .dz data' });
+        }
+    }
+    else {
+        writeFileSync(gitignorePath, dzIgnoreEntry);
+        steps.push({ name: 'Create .gitignore', status: 'done', detail: 'with .dz entries' });
+    }
+    return {
+        steps,
+        totalSteps: steps.length,
+        completed: steps.filter((s) => s.status === 'done').length,
+        skipped: steps.filter((s) => s.status === 'skipped').length,
+    };
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-core",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",
@@ -26,11 +26,11 @@
   "dependencies": {
     "yaml": "^2.0.0",
     "@dzhechkov/adapter-claude": "0.2.0",
-    "@dzhechkov/adapter-openclaude": "0.1.0",
     "@dzhechkov/adapter-opencode": "0.2.0",
+    "@dzhechkov/adapter-codex": "0.2.0",
     "@dzhechkov/adapter-hermes": "0.2.0",
-    "@dzhechkov/core": "0.2.0",
-    "@dzhechkov/adapter-codex": "0.2.0"
+    "@dzhechkov/adapter-openclaude": "0.1.0",
+    "@dzhechkov/core": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/src/index.ts

@@ -20,6 +20,8 @@ export { benchmarkSkill, benchmarkSkills, compareSkills } from './benchmark.js';
 export { buildRegistry, searchRegistry, filterByCategory } from './registry.js';
 export { recommend } from './recommend.js';
 export { pretrain } from './pretrain.js';
+export { runSetup } from './setup.js';
+export type { SetupOptions, SetupResult, SetupStep } from './setup.js';
 export type { PretrainResult, DetectedTech } from './pretrain.js';
 export type { RecommendationReport, SkillRecommendation } from './recommend.js';
 export { discoverPackages, publishPackages } from './publish.js';

package/src/setup.ts

@@ -0,0 +1,177 @@
+/**
+ * Full environment setup — skills + hooks + memory + pretrain.
+ *
+ * Unlike `dz init` (skills only), `dz setup` configures the complete
+ * self-learning environment:
+ * 1. Skills installation (via init)
+ * 2. Claude Code hooks (session-start/end for memory)
+ * 3. Memory database initialization (.dz/memory.db)
+ * 4. Pretrain (project analysis → auto-recommend)
+ *
+ * All operations are additive — never overwrites existing files.
+ *
+ * @packageDocumentation
+ */
+
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** Setup options. */
+export interface SetupOptions {
+  readonly projectRoot: string;
+  readonly target: string;
+  readonly preset?: string | undefined;
+  readonly noHooks?: boolean | undefined;
+  readonly noMemory?: boolean | undefined;
+  readonly noPretrain?: boolean | undefined;
+  readonly force?: boolean | undefined;
+}
+
+/** Setup result. */
+export interface SetupResult {
+  readonly steps: readonly SetupStep[];
+  readonly totalSteps: number;
+  readonly completed: number;
+  readonly skipped: number;
+}
+
+/** A single setup step. */
+export interface SetupStep {
+  readonly name: string;
+  readonly status: 'done' | 'skipped' | 'error';
+  readonly detail: string;
+}
+
+/** Generate Claude Code hooks configuration for self-learning. */
+function generateHooksConfig(projectRoot: string): string {
+  const dzDir = join(projectRoot, '.dz');
+  return JSON.stringify({
+    hooks: {
+      SessionStart: [{
+        type: 'command',
+        command: `node -e "const fs=require('fs');const p='${dzDir}/memory.db';const d=new Date().toISOString();fs.appendFileSync('${dzDir}/sessions.jsonl',JSON.stringify({event:'start',ts:d})+'\\n')"`,
+      }],
+      SessionEnd: [{
+        type: 'command',
+        command: `node -e "const fs=require('fs');const d=new Date().toISOString();fs.appendFileSync('${dzDir}/sessions.jsonl',JSON.stringify({event:'end',ts:d})+'\\n')"`,
+      }],
+    },
+  }, null, 2);
+}
+
+/** Generate .dz/config.json with learning settings. */
+function generateDzConfig(target: string, preset: string | undefined): string {
+  return JSON.stringify({
+    version: '1.0.0',
+    target,
+    preset: preset ?? null,
+    learning: {
+      enabled: true,
+      sessionTracking: true,
+      patternConsolidation: true,
+      retentionDays: 90,
+    },
+    memory: {
+      backend: 'jsonl',
+      path: '.dz/sessions.jsonl',
+      maxSizeMb: 10,
+    },
+    hooks: {
+      sessionStart: true,
+      sessionEnd: true,
+    },
+  }, null, 2);
+}
+
+/** Run full environment setup. */
+export function runSetup(opts: SetupOptions): SetupResult {
+  const steps: SetupStep[] = [];
+  const dzDir = join(opts.projectRoot, '.dz');
+
+  // Step 1: Create .dz directory
+  if (!existsSync(dzDir)) {
+    mkdirSync(dzDir, { recursive: true });
+    steps.push({ name: 'Create .dz directory', status: 'done', detail: dzDir });
+  } else {
+    steps.push({ name: 'Create .dz directory', status: 'skipped', detail: 'already exists' });
+  }
+
+  // Step 2: Write .dz/config.json
+  const configPath = join(dzDir, 'config.json');
+  if (!existsSync(configPath) || opts.force) {
+    writeFileSync(configPath, generateDzConfig(opts.target, opts.preset));
+    steps.push({ name: 'Write .dz/config.json', status: 'done', detail: 'learning + memory config' });
+  } else {
+    steps.push({ name: 'Write .dz/config.json', status: 'skipped', detail: 'already exists (use --force)' });
+  }
+
+  // Step 3: Initialize session log
+  const sessionsPath = join(dzDir, 'sessions.jsonl');
+  if (!existsSync(sessionsPath)) {
+    writeFileSync(sessionsPath, '');
+    steps.push({ name: 'Initialize sessions.jsonl', status: 'done', detail: 'session tracking ready' });
+  } else {
+    steps.push({ name: 'Initialize sessions.jsonl', status: 'skipped', detail: 'already exists' });
+  }
+
+  // Step 4: Initialize patterns store
+  const patternsPath = join(dzDir, 'patterns.jsonl');
+  if (!existsSync(patternsPath)) {
+    writeFileSync(patternsPath, '');
+    steps.push({ name: 'Initialize patterns.jsonl', status: 'done', detail: 'pattern learning ready' });
+  } else {
+    steps.push({ name: 'Initialize patterns.jsonl', status: 'skipped', detail: 'already exists' });
+  }
+
+  // Step 5: Configure hooks (write to .claude/settings.json)
+  if (!opts.noHooks) {
+    const settingsDir = join(opts.projectRoot, '.claude');
+    const settingsPath = join(settingsDir, 'settings.json');
+
+    if (!existsSync(settingsPath) || opts.force) {
+      mkdirSync(settingsDir, { recursive: true });
+      writeFileSync(settingsPath, generateHooksConfig(opts.projectRoot));
+      steps.push({ name: 'Configure hooks', status: 'done', detail: 'session-start + session-end hooks' });
+    } else {
+      // Merge hooks into existing settings
+      try {
+        const existing = JSON.parse(readFileSync(settingsPath, 'utf-8')) as Record<string, unknown>;
+        if (!existing['hooks']) {
+          const hooks = JSON.parse(generateHooksConfig(opts.projectRoot));
+          existing['hooks'] = hooks.hooks;
+          writeFileSync(settingsPath, JSON.stringify(existing, null, 2));
+          steps.push({ name: 'Configure hooks', status: 'done', detail: 'merged into existing settings' });
+        } else {
+          steps.push({ name: 'Configure hooks', status: 'skipped', detail: 'hooks already configured' });
+        }
+      } catch {
+        steps.push({ name: 'Configure hooks', status: 'skipped', detail: 'could not parse existing settings' });
+      }
+    }
+  } else {
+    steps.push({ name: 'Configure hooks', status: 'skipped', detail: '--no-hooks' });
+  }
+
+  // Step 6: Update .gitignore
+  const gitignorePath = join(opts.projectRoot, '.gitignore');
+  const dzIgnoreEntry = '\n# DZ Harness learning data\n.dz/sessions.jsonl\n.dz/patterns.jsonl\n';
+  if (existsSync(gitignorePath)) {
+    const content = readFileSync(gitignorePath, 'utf-8');
+    if (!content.includes('.dz/sessions.jsonl')) {
+      writeFileSync(gitignorePath, content + dzIgnoreEntry);
+      steps.push({ name: 'Update .gitignore', status: 'done', detail: 'added .dz/sessions.jsonl + patterns.jsonl' });
+    } else {
+      steps.push({ name: 'Update .gitignore', status: 'skipped', detail: 'already ignoring .dz data' });
+    }
+  } else {
+    writeFileSync(gitignorePath, dzIgnoreEntry);
+    steps.push({ name: 'Create .gitignore', status: 'done', detail: 'with .dz entries' });
+  }
+
+  return {
+    steps,
+    totalSteps: steps.length,
+    completed: steps.filter((s) => s.status === 'done').length,
+    skipped: steps.filter((s) => s.status === 'skipped').length,
+  };
+}