@lannguyensi/harness 0.5.0

package/dist/cli/adopt/index.js.map

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

package/dist/cli/apply/apply.d.ts

@@ -0,0 +1,49 @@
+import { type DriftedAsset } from "../../io/harness-lock.js";
+import { type ThreeStateVerdict } from "../../io/three-state.js";
+export declare const GENERATED_DIRNAME = "harness.generated";
+export declare const SETTINGS_BASENAME = "settings.json";
+export declare const MEMORY_BASENAME = "MEMORY.md";
+export declare const MANIFEST_BASENAME = "harness.yaml";
+export interface ApplyOptions {
+    configPath?: string;
+    homeDir?: string;
+    project?: string;
+    dryRun?: boolean;
+    overwriteDrift?: boolean;
+    /** Test-injectable confirmation prompt; defaults to a stdin readline. */
+    prompt?: (message: string) => Promise<string>;
+}
+export type ApplyOutcome = "no-changes" | "applied" | "drift-refuse" | "drift-discarded" | "would-apply";
+export interface FileApplyOutcome {
+    basename: string;
+    path: string;
+    verdict: ThreeStateVerdict;
+    /** Unified diff, present when verdict is `drift-refuse`. */
+    diff?: string;
+    /** True when `expected !== onDiskCurrent` (whether or not we wrote). */
+    changed: boolean;
+}
+export interface ApplyResult {
+    manifestPath: string;
+    generatedDir: string;
+    files: FileApplyOutcome[];
+    warnings: string[];
+    restartHints: string[];
+    /**
+     * Locked assets whose on-disk SHA-256 has drifted since the lock was last
+     * written. Computed on every apply (when a lock exists), reported but
+     * not enforced: apply proceeds, the drift is surfaced as warning-style
+     * output, and the lock is rewritten with current SHAs at the end of the
+     * run. Wrap apply in a script that greps for `asset drift detected:` to
+     * upgrade to enforcement.
+     */
+    lockDrift: DriftedAsset[];
+    outcome: ApplyOutcome;
+    written: boolean;
+    dryRun: boolean;
+    /** Path of the harness.lock that was (or would be) written. */
+    lockPath: string;
+}
+declare const DRIFT_HINT_MESSAGE = "run \"harness adopt <file>\" to capture changes, or re-run with --overwrite-drift to discard them";
+export declare function apply(opts?: ApplyOptions): Promise<ApplyResult>;
+export { DRIFT_HINT_MESSAGE };

package/dist/cli/apply/apply.js

@@ -0,0 +1,333 @@
+// `harness apply [--dry-run] [--overwrite-drift]`.
+//
+// Pipeline:
+//   1. Load the effective manifest.
+//   2. Generate expected runtime files: settings.json (Phase 3 #2),
+//      MEMORY.md index (Phase 3 #3).
+//   3. Read `harness.generated/.last-apply` (Phase 3 #1) if present.
+//   4. Read on-disk `harness.generated/<file>` if present.
+//   5. If `harness.lock` exists, hash every locked asset / memory-dir
+//      Merkle and surface mismatches as `lockDrift` (Phase 3 #6,
+//      warn-only). Drift is reported on every code path including
+//      --dry-run so users can preview without writing.
+//   6. Three-state-compare per file (Phase 3 #1):
+//        no-drift       → write expected (overwrite is safe)
+//        safe-overwrite → write expected (no on-disk file existed)
+//        drift-refuse   → refuse with diff + adopt-or-overwrite hint
+//   7. `--overwrite-drift` requires literal `yes` confirmation before
+//      discarding on-disk changes; on confirm, treat refusals as
+//      safe-overwrite.
+//   8. `--dry-run` prints the would-be diff + would-emit hints, exits 0
+//      without writing.
+//   9. After successful write: refresh `.last-apply` (with a manifest
+//      snapshot for the next apply's restart-hint comparison), write
+//      `harness.lock` next to `harness.yaml`, emit restart hints. The
+//      idempotent no-op path also refreshes the lock when asset drift
+//      was detected so the drift report is not "sticky".
+import * as crypto from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import * as readline from "node:readline/promises";
+import { atomicWriteFile } from "../../io/atomic-write.js";
+import { LOCK_BASENAME, buildLockEntries, computeDrift, readLock, writeLock, } from "../../io/harness-lock.js";
+import { buildLastApply, readLastApply, sha256Hex, verifyLastApplyIntegrity, writeLastApply, } from "../../io/last-apply.js";
+import { unifiedDiff } from "../../io/patch.js";
+import { emitRestartHints } from "../../io/restart-hints.js";
+import { compare } from "../../io/three-state.js";
+import { parseManifest } from "../../schema/index.js";
+import { EX_NOINPUT, HarnessExitError } from "../exit-codes.js";
+import { loadManifest } from "../loader.js";
+import { generateMemoryIndex } from "./generate-memory-index.js";
+import { generateSettings } from "./generate-settings.js";
+export const GENERATED_DIRNAME = "harness.generated";
+export const SETTINGS_BASENAME = "settings.json";
+export const MEMORY_BASENAME = "MEMORY.md";
+export const MANIFEST_BASENAME = "harness.yaml";
+const DRIFT_HINT_MESSAGE = 'run "harness adopt <file>" to capture changes, or re-run with --overwrite-drift to discard them';
+function resolveManifestPath(opts) {
+    if (opts.configPath)
+        return path.resolve(opts.configPath);
+    return path.join(opts.homeDir ?? path.join(os.homedir(), ".claude"), MANIFEST_BASENAME);
+}
+// `harness.generated/` lives next to whichever manifest is in use. If the
+// user passed `--config /repo/path/harness.yaml`, generated artefacts go to
+// `/repo/path/harness.generated/` (NOT `~/.claude/harness.generated/`). This
+// avoids the footgun of `harness apply --config <some-other-tree>` writing
+// state into the user's global runtime directory.
+function resolveGeneratedDir(opts, manifestPath) {
+    if (opts.homeDir !== undefined)
+        return path.join(opts.homeDir, GENERATED_DIRNAME);
+    return path.join(path.dirname(manifestPath), GENERATED_DIRNAME);
+}
+// Prompts must survive `harness apply | tee log` (the user still needs to
+// see the question even when stdout is piped), so we write to stderr and
+// read from stdin. Don't "fix" this back to stdout.
+async function readlinePrompt(message) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        return await rl.question(message);
+    }
+    finally {
+        rl.close();
+    }
+}
+function buildExpectedFiles(manifest, opts) {
+    const settings = `${JSON.stringify(generateSettings(manifest), null, 2)}\n`;
+    const indexResult = generateMemoryIndex(manifest, {
+        ...(opts.homeDir !== undefined ? { homeDir: opts.homeDir } : {}),
+        ...(opts.project !== undefined ? { projectName: opts.project } : {}),
+    });
+    return {
+        files: [
+            { basename: SETTINGS_BASENAME, content: settings },
+            { basename: MEMORY_BASENAME, content: indexResult.content },
+        ],
+        warnings: indexResult.warnings,
+    };
+}
+function readOnDisk(filePath) {
+    try {
+        return fs.readFileSync(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function buildPrevManifestForHints(record) {
+    if (!record?.manifest)
+        return null;
+    // Reject a snapshot whose stored sha256 disagrees with the recorded
+    // content. Treats integrity failure as "no prev manifest" (silent: same
+    // surface as a baseline record without a manifest field), so a corrupted
+    // .last-apply does not produce confidently-wrong restart hints.
+    const integrity = verifyLastApplyIntegrity({
+        files: { manifest: record.manifest },
+    });
+    if (integrity.length > 0)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(record.manifest.content);
+    }
+    catch {
+        return null;
+    }
+    try {
+        return parseManifest(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+export async function apply(opts = {}) {
+    const manifestPath = resolveManifestPath(opts);
+    if (!fs.existsSync(manifestPath)) {
+        throw new HarnessExitError(`harness manifest not found at ${manifestPath}; run \`harness init\` first`, EX_NOINPUT);
+    }
+    const generatedDir = resolveGeneratedDir(opts, manifestPath);
+    const lockPath = path.join(path.dirname(manifestPath), LOCK_BASENAME);
+    const loaderOpts = {
+        configPath: manifestPath,
+    };
+    if (opts.homeDir !== undefined)
+        loaderOpts.homeDir = opts.homeDir;
+    if (opts.project !== undefined)
+        loaderOpts.project = opts.project;
+    const { manifest } = loadManifest(loaderOpts);
+    const { files: expected, warnings } = buildExpectedFiles(manifest, opts);
+    const lastApply = readLastApply(generatedDir);
+    // Asset-content drift detection (Phase 3 #6): if a previous apply wrote
+    // harness.lock, re-hash every locked asset / memory-dir Merkle and report
+    // mismatches. Warn-only: apply still proceeds and the lock is rewritten
+    // at the end of the run. Users wanting enforcement wrap apply in a script
+    // that greps for `asset drift detected:`.
+    //
+    // We compute against the *previous* lock (read here, before the manifest
+    // is consulted to build the new lock). An asset removed from the manifest
+    // in this same apply still surfaces if it drifted — the reportable event
+    // is "the file on disk diverged from what was last-known", regardless of
+    // whether the manifest still references it.
+    const previousLock = readLock(lockPath);
+    const lockDrift = previousLock !== null ? computeDrift(previousLock) : [];
+    const fileOutcomes = [];
+    let anyDriftRefuse = false;
+    let anyChanged = false;
+    for (const f of expected) {
+        const target = path.join(generatedDir, f.basename);
+        const onDisk = readOnDisk(target);
+        const lastAppliedContent = lastApply?.files[f.basename]?.content ?? null;
+        const verdict = compare({
+            manifestExpected: f.content,
+            lastApplied: lastAppliedContent,
+            onDiskCurrent: onDisk,
+        });
+        const outcome = {
+            basename: f.basename,
+            path: target,
+            verdict,
+            changed: f.content !== onDisk,
+        };
+        if (verdict === "drift-refuse") {
+            anyDriftRefuse = true;
+            outcome.diff = unifiedDiff({
+                fileName: f.basename,
+                oldText: lastAppliedContent ?? "",
+                newText: onDisk ?? "",
+                oldHeader: "last-apply",
+                newHeader: "on-disk",
+            });
+        }
+        if (outcome.changed)
+            anyChanged = true;
+        fileOutcomes.push(outcome);
+    }
+    if (anyDriftRefuse && !opts.overwriteDrift) {
+        return {
+            manifestPath,
+            generatedDir,
+            files: fileOutcomes,
+            warnings,
+            restartHints: [],
+            outcome: "drift-refuse",
+            lockDrift,
+            written: false,
+            dryRun: opts.dryRun ?? false,
+            lockPath,
+        };
+    }
+    if (anyDriftRefuse && opts.overwriteDrift) {
+        const promptFn = opts.prompt ?? readlinePrompt;
+        const answer = await promptFn("Type 'yes' to discard on-disk hand-edits and overwrite with manifest-expected content: ");
+        // Case-insensitive comparison: a user typing `YES` or `Yes` is clearly
+        // confirming. We still reject `y` per spec ("literal yes, not y").
+        if (answer.trim().toLowerCase() !== "yes") {
+            return {
+                manifestPath,
+                generatedDir,
+                files: fileOutcomes,
+                warnings,
+                restartHints: [],
+                outcome: "drift-discarded",
+                lockDrift,
+                written: false,
+                dryRun: opts.dryRun ?? false,
+                lockPath,
+            };
+        }
+        // Confirmed: continue to the write phase. The per-file `verdict` field
+        // remains `drift-refuse` so callers can still see which files would
+        // have been refused; the wrapper outcome is `applied` post-write.
+    }
+    // Restart hints: compare the previous-apply's manifest snapshot to the
+    // current effective manifest.
+    const prevManifest = buildPrevManifestForHints(lastApply);
+    const restartHints = prevManifest ? emitRestartHints(prevManifest, manifest) : [];
+    if (opts.dryRun) {
+        return {
+            manifestPath,
+            generatedDir,
+            files: fileOutcomes,
+            warnings,
+            restartHints,
+            outcome: anyChanged ? "would-apply" : "no-changes",
+            lockDrift,
+            written: false,
+            dryRun: true,
+            lockPath,
+        };
+    }
+    if (!anyChanged && lastApply !== null) {
+        // Idempotent no-op for generated files. If asset-content drift was
+        // detected against harness.lock, rewrite the lock now with current
+        // SHAs so the drift is not "sticky": the user sees the drift line
+        // once, the next apply is clean. Without this, every subsequent
+        // apply re-reports the same drift forever until something else in
+        // the manifest changes.
+        if (lockDrift.length > 0) {
+            const refreshed = buildLockEntries(manifest, {
+                ...(opts.homeDir !== undefined ? { homeDir: opts.homeDir } : {}),
+                ...(opts.project !== undefined ? { projectName: opts.project } : {}),
+            });
+            writeLock(lockPath, refreshed);
+        }
+        return {
+            manifestPath,
+            generatedDir,
+            files: fileOutcomes,
+            warnings,
+            restartHints,
+            outcome: "no-changes",
+            lockDrift,
+            written: false,
+            dryRun: false,
+            lockPath,
+        };
+    }
+    fs.mkdirSync(generatedDir, { recursive: true });
+    for (const f of expected) {
+        const target = path.join(generatedDir, f.basename);
+        atomicWriteFile(target, f.content);
+    }
+    // Compute lock + memory-dir snapshot BEFORE writing .last-apply so the
+    // record is built once and persisted atomically. A previous version of
+    // this code wrote .last-apply twice (once without memoryDirs, then again
+    // with it), which produced a half-state if the process died between
+    // writes: the next `--memory-detail` diff would have seen every on-disk
+    // .md as "added" against an empty index. Single write closes that gap.
+    const lockEntries = buildLockEntries(manifest, {
+        ...(opts.homeDir !== undefined ? { homeDir: opts.homeDir } : {}),
+        ...(opts.project !== undefined ? { projectName: opts.project } : {}),
+    });
+    const newRecord = buildLastApply(Object.fromEntries(expected.map((f) => [f.basename, f.content])));
+    const manifestSnapshotJson = JSON.stringify(manifest);
+    newRecord.manifest = {
+        sha256: sha256Hex(manifestSnapshotJson),
+        content: manifestSnapshotJson,
+    };
+    const memoryDirSnapshots = collectMemoryDirSnapshots(lockEntries);
+    if (Object.keys(memoryDirSnapshots).length > 0) {
+        newRecord.memoryDirs = memoryDirSnapshots;
+    }
+    writeLastApply(generatedDir, newRecord);
+    writeLock(lockPath, lockEntries);
+    return {
+        manifestPath,
+        generatedDir,
+        files: fileOutcomes,
+        warnings,
+        restartHints,
+        outcome: "applied",
+        lockDrift,
+        written: true,
+        dryRun: false,
+        lockPath,
+    };
+}
+function sha256OfFile(filePath) {
+    return crypto.createHash("sha256").update(fs.readFileSync(filePath)).digest("hex");
+}
+function collectMemoryDirSnapshots(lockEntries) {
+    const out = {};
+    for (const e of lockEntries) {
+        if (e.kind !== "memory-dir")
+            continue;
+        const fileHashes = {};
+        let dirents;
+        try {
+            dirents = fs.readdirSync(e.path, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const d of dirents) {
+            if (!d.isFile() || !d.name.endsWith(".md"))
+                continue;
+            fileHashes[d.name] = sha256OfFile(path.join(e.path, d.name));
+        }
+        out[e.path] = { sha256: e.sha256, fileHashes };
+    }
+    return out;
+}
+export { DRIFT_HINT_MESSAGE };
+//# sourceMappingURL=apply.js.map

package/dist/cli/apply/apply.js.map

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

package/dist/cli/apply/generate-memory-index.d.ts

@@ -0,0 +1,17 @@
+import type { Manifest } from "../../schema/index.js";
+export interface MemoryIndexEntry {
+    name: string;
+    description: string;
+    basename: string;
+    directory: string;
+}
+export interface GenerateMemoryIndexResult {
+    content: string;
+    entries: MemoryIndexEntry[];
+    warnings: string[];
+}
+export interface GenerateMemoryIndexOptions {
+    homeDir?: string;
+    projectName?: string;
+}
+export declare function generateMemoryIndex(manifest: Manifest, opts?: GenerateMemoryIndexOptions): GenerateMemoryIndexResult;

package/dist/cli/apply/generate-memory-index.js

@@ -0,0 +1,167 @@
+// Generate `harness.generated/MEMORY.md`: the index that lists every memory
+// file the router would surface, derived from `memory.directories[]`. Memory
+// markdown files themselves stay user-owned (per ROADMAP non-goals); only
+// the index is generated.
+//
+// Output format mirrors the canonical hand-curated MEMORY.md convention:
+//
+//   - [Name](filename.md) — description
+//
+// Empty directories produce a header-only output; missing or unreadable
+// frontmatter surfaces in the `warnings[]` array on the result so the
+// caller (Phase 3 #4 `harness apply`) can render a doctor-style report
+// without aborting.
+//
+// Frontmatter shape mirrors agent-memory's `MemoryFrontmatter`: `name` and
+// `type` are required (matches the canonical loader at
+// `agent-memory/packages/memory-router/src/memory/loader.ts`, which rejects
+// on `!fm.name || !fm.type`). `description` is recommended (its absence is
+// a warning but not a hard skip). `topics` and other fields are not
+// surfaced in the index.
+//
+// `name` and `description` are passed through verbatim into the markdown
+// output. The user authors their own frontmatter, so we trust it; no
+// escaping is performed for `[`, `]`, `(`, `)`, or backticks. A maliciously
+// crafted `name` would produce broken markdown but not security issues
+// (the index is read by humans and by tools that already accept arbitrary
+// markdown).
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { parse as parseYaml } from "yaml";
+// Mirror the canonical loader's regex (CRLF-tolerant) so files saved on
+// Windows or by editors that normalise to CRLF parse identically here.
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+function expandHome(p, homeDir) {
+    const home = homeDir ?? os.homedir();
+    if (p === "~")
+        return home;
+    if (p.startsWith("~/"))
+        return path.join(home, p.slice(2));
+    return p;
+}
+function resolveDirPath(dirPath, opts) {
+    let resolved = expandHome(dirPath, opts.homeDir);
+    if (resolved.includes("{project}")) {
+        if (!opts.projectName)
+            return null;
+        resolved = resolved.split("{project}").join(opts.projectName);
+    }
+    return resolved;
+}
+function parseFrontmatter(raw) {
+    const match = FRONTMATTER_RE.exec(raw);
+    if (!match)
+        return null;
+    let parsed;
+    try {
+        parsed = parseYaml(match[1] ?? "");
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        return null;
+    return parsed;
+}
+function readEntry(directory, basename, warnings) {
+    const fullPath = path.join(directory, basename);
+    let content;
+    try {
+        content = fs.readFileSync(fullPath, "utf8");
+    }
+    catch {
+        warnings.push(`${fullPath}: unreadable`);
+        return null;
+    }
+    const fm = parseFrontmatter(content);
+    if (!fm) {
+        warnings.push(`${fullPath}: no frontmatter or malformed YAML`);
+        return null;
+    }
+    if (typeof fm.name !== "string" || fm.name.length === 0) {
+        warnings.push(`${fullPath}: frontmatter missing required \`name\` field`);
+        return null;
+    }
+    if (typeof fm.type !== "string" || fm.type.length === 0) {
+        // Matches the canonical loader's strict requirement; a memory missing
+        // `type` is rejected by the router at runtime and would advertise a
+        // memory the index promises but the router won't surface.
+        warnings.push(`${fullPath}: frontmatter missing required \`type\` field`);
+        return null;
+    }
+    const description = typeof fm.description === "string" ? fm.description : "";
+    if (description.length === 0) {
+        warnings.push(`${fullPath}: frontmatter missing \`description\` (entry kept, hook empty)`);
+    }
+    return { name: fm.name, description, basename, directory };
+}
+function listMarkdownFiles(directory, warnings) {
+    let dirents;
+    try {
+        dirents = fs.readdirSync(directory, { withFileTypes: true });
+    }
+    catch {
+        warnings.push(`${directory}: directory not readable, skipped`);
+        return [];
+    }
+    return dirents
+        .filter((d) => d.isFile() &&
+        d.name.endsWith(".md") &&
+        // Skip the curated MEMORY.md itself: in the canonical layout it has
+        // no frontmatter and exists as a hand-written sibling to the entries.
+        // Excluding it here avoids a spurious "no frontmatter" warning and
+        // self-reference in multi-dir aggregation.
+        d.name !== "MEMORY.md")
+        .map((d) => d.name)
+        .sort();
+}
+export function generateMemoryIndex(manifest, opts = {}) {
+    const warnings = [];
+    const entries = [];
+    for (const dir of manifest.memory.directories) {
+        const resolved = resolveDirPath(dir.path, opts);
+        if (resolved === null)
+            continue; // {project}-placeholder without projectName context
+        const files = listMarkdownFiles(resolved, warnings);
+        for (const file of files) {
+            const entry = readEntry(resolved, file, warnings);
+            if (entry !== null)
+                entries.push(entry);
+        }
+    }
+    // Surface basename collisions across directories: the index uses
+    // basename as the link target, so two entries with the same basename
+    // resolve to the same path and one becomes unclickable. This is a
+    // documentation gap, not a hard error — the entries are still kept.
+    const basenameCounts = new Map();
+    for (const e of entries) {
+        basenameCounts.set(e.basename, (basenameCounts.get(e.basename) ?? 0) + 1);
+    }
+    for (const [base, count] of basenameCounts) {
+        if (count > 1) {
+            warnings.push(`basename collision across memory directories: \`${base}\` appears ${count} times — only one link target resolves`);
+        }
+    }
+    entries.sort((a, b) => {
+        // Stable sort by (name, basename, directory) so tie-breaking is
+        // deterministic across directories holding files with the same name.
+        if (a.name !== b.name)
+            return a.name < b.name ? -1 : 1;
+        if (a.basename !== b.basename)
+            return a.basename < b.basename ? -1 : 1;
+        return a.directory < b.directory ? -1 : a.directory > b.directory ? 1 : 0;
+    });
+    const lines = [];
+    for (const e of entries) {
+        if (e.description.length > 0) {
+            lines.push(`- [${e.name}](${e.basename}) — ${e.description}`);
+        }
+        else {
+            lines.push(`- [${e.name}](${e.basename})`);
+        }
+    }
+    const content = lines.length > 0 ? `${lines.join("\n")}\n` : "";
+    return { content, entries, warnings };
+}
+//# sourceMappingURL=generate-memory-index.js.map

package/dist/cli/apply/generate-memory-index.js.map

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

package/dist/cli/apply/generate-settings.d.ts

@@ -0,0 +1,15 @@
+import type { Manifest } from "../../schema/index.js";
+export declare const DEFAULT_BUDGET_MS = 30000;
+export interface SettingsHookCommand {
+    type: "command";
+    command: string;
+    timeout?: number;
+}
+export interface SettingsHookGroup {
+    matcher?: string;
+    hooks: SettingsHookCommand[];
+}
+export interface SettingsRoot {
+    hooks: Record<string, SettingsHookGroup[]>;
+}
+export declare function generateSettings(manifest: Manifest): SettingsRoot;