@sentropic/harness 0.1.1 → 0.2.0

package/dist/cli/run.js

@@ -1,55 +1,32 @@
-import { readFileSync } from 'node:fs';
-import { parseBranchMd } from '../branch-md/parse.js';
-import { checkScope } from '../checks/scope-check.js';
 import { checkBranch } from '../checks/branch-check.js';
 import { toVerificationRun } from '../run/emit.js';
 import { sentropicProfile } from '../profile/sentropic.js';
 import { stubProfile } from '../profile/stub.js';
-function parseFlags(args) {
-    const positionals = [];
-    const flags = {};
-    for (let i = 0; i < args.length; i++) {
-        const a = args[i];
-        if (a.startsWith('--')) {
-            const key = a.slice(2);
-            const next = args[i + 1];
-            if (next === undefined || next.startsWith('--')) {
-                flags[key] = true;
-            }
-            else {
-                flags[key] = next;
-                i++;
-            }
-        }
-        else {
-            positionals.push(a);
-        }
-    }
-    return { positionals, flags };
-}
-function str(v) {
-    return typeof v === 'string' ? v : undefined;
-}
-function list(v) {
-    const s = str(v);
-    return s ? s.split(/[\s,]+/).filter(Boolean) : [];
-}
-const USAGE = 'usage: harness check <scope|branch> [--current-branch <b>] [--expected-branch <b>] ' +
-    '[--staged-files <list>] [--branch-md <path>] [--profile sentropic|stub] [--json]';
-/**
- * Pure, arg-based CLI driver — reads everything from `argv`, writes via `out`, returns an exit code.
- * No internal git calls (the caller supplies branch + staged files), no `process.exit`.
- * Advisory (D5 Layer A): a failing check returns 0; only a usage error returns non-zero.
- * Acquiring git state under Docker-first (the `make scope-check` passthrough) is a separate,
- * to-be-double-reviewed concern.
- */
-export function runHarnessCli(argv, out) {
-    const { positionals, flags } = parseFlags(argv);
-    const command = positionals[0];
+import { parseFlags, str } from './args.js';
+import { scopeFromFlags } from './scope.js';
+import { handleMethodVerb } from './method-verbs.js';
+import { handleMechanicalVerb } from './mechanical-verbs.js';
+const USAGE = [
+    'usage: harness check <scope|branch> [--current-branch <b>] [--expected-branch <b>] ' +
+        '[--staged-files <list>] [--branch-md <path>] [--profile sentropic|stub] [--json]',
+    '       harness verify [--category static|unit|integration|e2e|ci|uat] [--staged-files <list>] ' +
+        '[--current-branch <b>] [--expected-branch <b>] [--branch-md <path>] [--profile sentropic|stub] [--json]',
+    '       harness init [--profile sentropic|stub] [--json]',
+    '       harness audit [--staged-files <list>] [--branch-md <path>] [--profile sentropic|stub] [--json]',
+    '       harness brainstorm [<topic>] [--peers <n>] [--ladder study|vol|evol] [--json]',
+    '       harness test [<scope>] [--category unit|integration|e2e] [--watch] [--json]',
+    '       harness debug [<symptom>] [--json]',
+    '       harness review [<target>] [--consensus] [--peers <n>] [--json]',
+    '       harness plan [<spec>] [--lots <n>] [--json]',
+    '       harness branch <init|close> [<slug>] [--json]',
+    '       harness skills install --host <claude|codex|gemini> [--json]',
+].join('\n');
+/** The `check scope|branch` static checks (C2/C1) — emit a neutral VerificationRun. */
+function handleCheck(positionals, flags, out) {
     const sub = positionals[1];
-    if (command !== 'check' || (sub !== 'scope' && sub !== 'branch')) {
+    if (sub !== 'scope' && sub !== 'branch') {
         out(USAGE);
-        return command === undefined ? 0 : 2;
+        return 2;
     }
     const profile = str(flags.profile) === 'stub' ? stubProfile : sentropicProfile;
     const category = 'static';
@@ -59,27 +36,12 @@ export function runHarnessCli(argv, out) {
     if (sub === 'scope') {
         code = 'C2';
         commandLabel = 'harness check scope';
-        const branchMdPath = str(flags['branch-md']);
-        let parsed;
-        if (branchMdPath) {
-            try {
-                parsed = parseBranchMd(readFileSync(branchMdPath, 'utf8'));
-            }
-            catch {
-                out(`harness: cannot read plan file: ${branchMdPath}`);
-                return 2;
-            }
+        const outcome = scopeFromFlags(flags, profile);
+        if (outcome.unreadable !== undefined) {
+            out(`harness: cannot read plan file: ${outcome.unreadable}`);
+            return 2;
         }
-        result = checkScope({
-            stagedFiles: list(flags['staged-files']),
-            boundary: {
-                allowed: parsed?.allowedPaths ?? [],
-                forbidden: parsed?.forbiddenPaths ?? [],
-                conditional: parsed?.conditionalPaths ?? [],
-            },
-            profile,
-            declaredExceptions: parsed?.exceptions ?? [],
-        });
+        result = outcome.result;
     }
     else {
         code = 'C1';
@@ -113,4 +75,27 @@ export function runHarnessCli(argv, out) {
     }
     return 0;
 }
+/**
+ * Pure, arg-based CLI driver — reads everything from `argv`, writes via `out`, returns an exit code.
+ * No internal git calls (the caller supplies branch + staged files), no `process.exit`, no fs writes.
+ * Advisory (D5 Layer A): a failing check returns 0; only a usage error returns non-zero.
+ *
+ * Verb families: `check` (C1/C2 → VerificationRun); method/recorder verbs (brainstorm/test/debug/
+ * review/plan/branch/skills → WorkEvent + skill pointer, see `method-verbs.ts`).
+ */
+export function runHarnessCli(argv, out) {
+    const { positionals, flags } = parseFlags(argv);
+    const command = positionals[0];
+    if (command === 'check') {
+        return handleCheck(positionals, flags, out);
+    }
+    const mechanicalCode = handleMechanicalVerb(positionals, flags, out);
+    if (mechanicalCode !== null)
+        return mechanicalCode;
+    const methodCode = handleMethodVerb(positionals, flags, out);
+    if (methodCode !== null)
+        return methodCode;
+    out(USAGE);
+    return command === undefined ? 0 : 2;
+}
 //# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/cli/scope.d.ts

@@ -0,0 +1,12 @@
+import type { CheckResult } from '../artifacts/verification-run.js';
+import type { HarnessProfile } from '../profile/profile.js';
+import { type FlagValue } from './args.js';
+export interface ScopeOutcome {
+    /** The scope CheckResult, when inputs resolved. */
+    result?: CheckResult;
+    /** The unreadable plan-file path, when `--branch-md` could not be read. */
+    unreadable?: string;
+}
+/** Resolve `--branch-md` + `--staged-files` into a C2 scope CheckResult (pure but for the file read). */
+export declare function scopeFromFlags(flags: Record<string, FlagValue>, profile: HarnessProfile): ScopeOutcome;
+//# sourceMappingURL=scope.d.ts.map

package/dist/cli/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/cli/scope.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY,CAqBtG"}

package/dist/cli/scope.js

@@ -0,0 +1,31 @@
+// Shared scope-check input resolution — used by `check scope`, `verify`, and `audit` so the
+// BRANCH.md parsing + boundary wiring lives in ONE place (no duplicated file IO).
+import { readFileSync } from 'node:fs';
+import { parseBranchMd } from '../branch-md/parse.js';
+import { checkScope } from '../checks/scope-check.js';
+import { list, str } from './args.js';
+/** Resolve `--branch-md` + `--staged-files` into a C2 scope CheckResult (pure but for the file read). */
+export function scopeFromFlags(flags, profile) {
+    const branchMdPath = str(flags['branch-md']);
+    let parsed;
+    if (branchMdPath) {
+        try {
+            parsed = parseBranchMd(readFileSync(branchMdPath, 'utf8'));
+        }
+        catch {
+            return { unreadable: branchMdPath };
+        }
+    }
+    const result = checkScope({
+        stagedFiles: list(flags['staged-files']),
+        boundary: {
+            allowed: parsed?.allowedPaths ?? [],
+            forbidden: parsed?.forbiddenPaths ?? [],
+            conditional: parsed?.conditionalPaths ?? [],
+        },
+        profile,
+        declaredExceptions: parsed?.exceptions ?? [],
+    });
+    return { result };
+}
+//# sourceMappingURL=scope.js.map

package/dist/cli/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/cli/scope.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,kFAAkF;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAkB,MAAM,WAAW,CAAC;AAStD,yGAAyG;AACzG,MAAM,UAAU,cAAc,CAAC,KAAgC,EAAE,OAAuB;IACtF,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7C,IAAI,MAAoD,CAAC;IACzD,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACxC,QAAQ,EAAE;YACR,OAAO,EAAE,MAAM,EAAE,YAAY,IAAI,EAAE;YACnC,SAAS,EAAE,MAAM,EAAE,cAAc,IAAI,EAAE;YACvC,WAAW,EAAE,MAAM,EAAE,gBAAgB,IAAI,EAAE;SAC5C;QACD,OAAO;QACP,kBAAkB,EAAE,MAAM,EAAE,UAAU,IAAI,EAAE;KAC7C,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export declare const HARNESS_PACKAGE: "@sentropic/harness";
 export type { VerificationRun, VerificationCheck, VerificationCategory, Violation, ViolationSeverity, CheckResult, } from './artifacts/verification-run.js';
+export type { WorkEvent, WorkEventVerb, WorkEventStatus, WorkEventValue, } from './artifacts/work-event.js';
+export { toWorkEvent } from './run/work-event.js';
+export type { WorkEventInput, WorkEventContext } from './run/work-event.js';
 export type { HarnessProfile } from './profile/profile.js';
 export { sentropicProfile } from './profile/sentropic.js';
 export { stubProfile } from './profile/stub.js';
@@ -13,5 +16,7 @@ export { checkScope } from './checks/scope-check.js';
 export type { ScopeCheckInput } from './checks/scope-check.js';
 export { toVerificationRun } from './run/emit.js';
 export type { NamedCheck, VerificationContext } from './run/emit.js';
+export { HARNESS_SKILLS, HOST_SKILL_DIR, isHostId } from './skills/manifest.js';
+export type { SkillEntry, HostId } from './skills/manifest.js';
 export { runHarnessCli } from './cli/run.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,sBAAgC,CAAC;AAG7D,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EACjB,WAAW,GACZ,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAClF,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,sBAAgC,CAAC;AAG7D,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EACjB,WAAW,GACZ,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5E,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAClF,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChF,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -3,6 +3,7 @@
 // Tooling-only: no product-runtime imports (no Drizzle/Hono/Svelte/Mistral), no
 // `@sentropic/*` deps, and NO track import — harness only EMITS neutral artifacts.
 export const HARNESS_PACKAGE = '@sentropic/harness';
+export { toWorkEvent } from './run/work-event.js';
 export { sentropicProfile } from './profile/sentropic.js';
 export { stubProfile } from './profile/stub.js';
 // BRANCH.md parser.
@@ -13,6 +14,8 @@ export { classifyPath, matchGlob, globToRegExp } from './scope/scope-boundary.js
 export { checkBranch } from './checks/branch-check.js';
 export { checkScope } from './checks/scope-check.js';
 export { toVerificationRun } from './run/emit.js';
+// Harness skill-pack inventory — the native superpowers-surface replacement.
+export { HARNESS_SKILLS, HOST_SKILL_DIR, isHostId } from './skills/manifest.js';
 // Pure, arg-based CLI driver (the `harness` bin is a thin wrapper over this).
 export { runHarnessCli } from './cli/run.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,gFAAgF;AAChF,mFAAmF;AAEnF,MAAM,CAAC,MAAM,eAAe,GAAG,oBAA6B,CAAC;AAc7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGlF,uDAAuD;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,gFAAgF;AAChF,mFAAmF;AAEnF,MAAM,CAAC,MAAM,eAAe,GAAG,oBAA6B,CAAC;AAmB7D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGlF,uDAAuD;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,6EAA6E;AAC7E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhF,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/run/work-event.d.ts

@@ -0,0 +1,25 @@
+import type { WorkEvent, WorkEventStatus, WorkEventValue, WorkEventVerb } from '../artifacts/work-event.js';
+export interface WorkEventInput {
+    verb: WorkEventVerb;
+    status: WorkEventStatus;
+    subject?: string;
+    skill?: string;
+    refs?: Record<string, string>;
+    detail?: Record<string, WorkEventValue>;
+}
+export interface WorkEventContext {
+    runId: string;
+    commit: string;
+    branch: string;
+    env: string;
+    runner: string;
+    /** ISO-8601 timestamp (injected by the caller — the pure driver passes a placeholder). */
+    at: string;
+}
+/**
+ * Assemble a NEUTRAL `WorkEvent` from a method/branch act. harness EMITS this artifact and never
+ * writes into `@sentropic/track` — a track-side adapter ingests it (no track import here). Pure and
+ * deterministic: `subject`/`skill` are dropped when absent so the JSON stays minimal and stable.
+ */
+export declare function toWorkEvent(input: WorkEventInput, ctx: WorkEventContext): WorkEvent;
+//# sourceMappingURL=work-event.d.ts.map

package/dist/run/work-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-event.d.ts","sourceRoot":"","sources":["../../src/run/work-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAkBnF"}

package/dist/run/work-event.js

@@ -0,0 +1,27 @@
+/**
+ * Assemble a NEUTRAL `WorkEvent` from a method/branch act. harness EMITS this artifact and never
+ * writes into `@sentropic/track` — a track-side adapter ingests it (no track import here). Pure and
+ * deterministic: `subject`/`skill` are dropped when absent so the JSON stays minimal and stable.
+ */
+export function toWorkEvent(input, ctx) {
+    const event = {
+        schemaVersion: 1,
+        kind: 'work-event',
+        verb: input.verb,
+        status: input.status,
+        refs: input.refs ?? {},
+        detail: input.detail ?? {},
+        runId: ctx.runId,
+        commit: ctx.commit,
+        branch: ctx.branch,
+        env: ctx.env,
+        runner: ctx.runner,
+        at: ctx.at,
+    };
+    if (input.subject !== undefined)
+        event.subject = input.subject;
+    if (input.skill !== undefined)
+        event.skill = input.skill;
+    return event;
+}
+//# sourceMappingURL=work-event.js.map

package/dist/run/work-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-event.js","sourceRoot":"","sources":["../../src/run/work-event.ts"],"names":[],"mappings":"AA0BA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAqB,EAAE,GAAqB;IACtE,MAAM,KAAK,GAAc;QACvB,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;QAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,EAAE,EAAE,GAAG,CAAC,EAAE;KACX,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/D,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACzD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/skills/manifest.d.ts

@@ -0,0 +1,14 @@
+export type HostId = 'claude' | 'codex' | 'gemini';
+export interface SkillEntry {
+    /** Skill id; loaded by a host under the `harness/<name>` namespace. */
+    name: string;
+    /** One-line purpose. */
+    summary: string;
+    /** The superpowers skill this supersedes (drives the supersede directive), if any. */
+    supersedes?: string;
+}
+export declare const HARNESS_SKILLS: SkillEntry[];
+/** Host → the skills directory `skills install` copies the pack into. */
+export declare const HOST_SKILL_DIR: Record<HostId, string>;
+export declare function isHostId(s: string | undefined): s is HostId;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/skills/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/skills/manifest.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,UAAU,EAQtC,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIjD,CAAC;AAEF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,IAAI,MAAM,CAE3D"}

package/dist/skills/manifest.js

@@ -0,0 +1,25 @@
+// Canonical inventory of the harness skill pack — the NATIVE superpowers-surface replacement.
+//
+// `harness skills install --host <h>` reports this plan; the pack ships in the npm tarball under
+// `skills/<name>/SKILL.md` (see `package.json` `files`). The host loads each as `harness/<name>`.
+// `using-harness` MUST be loaded first — it carries the supersede directive that makes `harness/*`
+// take precedence over the superpowers skills it replaces.
+export const HARNESS_SKILLS = [
+    { name: 'using-harness', summary: 'index + supersede directive (load FIRST)', supersedes: 'using-superpowers' },
+    { name: 'brainstorm', summary: 'spec-ladder STUDY→VOL→EVOL + ≥2-peer review + batched decisions', supersedes: 'brainstorming' },
+    { name: 'test', summary: 'test-pyramid + scoped-test loop (not "tdd")', supersedes: 'test-driven-development' },
+    { name: 'debug', summary: 'generic root-cause loop', supersedes: 'systematic-debugging' },
+    { name: 'review', summary: '≥2-peer consensus review', supersedes: 'requesting-code-review' },
+    { name: 'plan', summary: 'spec-ladder + BRANCH.md lots; completes with track', supersedes: 'writing-plans' },
+    { name: 'adopt', summary: 'adapt the harness method to ANY repo (profile)' },
+];
+/** Host → the skills directory `skills install` copies the pack into. */
+export const HOST_SKILL_DIR = {
+    claude: '.claude/skills',
+    codex: '.codex/skills',
+    gemini: '.gemini/skills',
+};
+export function isHostId(s) {
+    return s === 'claude' || s === 'codex' || s === 'gemini';
+}
+//# sourceMappingURL=manifest.js.map

package/dist/skills/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/skills/manifest.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,mGAAmG;AACnG,2DAA2D;AAa3D,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,0CAA0C,EAAE,UAAU,EAAE,mBAAmB,EAAE;IAC/G,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,iEAAiE,EAAE,UAAU,EAAE,eAAe,EAAE;IAC/H,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,6CAA6C,EAAE,UAAU,EAAE,yBAAyB,EAAE;IAC/G,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,UAAU,EAAE,sBAAsB,EAAE;IACzF,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,wBAAwB,EAAE;IAC7F,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oDAAoD,EAAE,UAAU,EAAE,eAAe,EAAE;IAC5G,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,gDAAgD,EAAE;CAC7E,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,gBAAgB;CACzB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,CAAqB;IAC5C,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,QAAQ,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sentropic/harness",
-  "version": "0.1.1",
-  "description": "Neutral, host-agnostic code-work / PR-workflow tooling for AI dev: branch/scope/lot/verify discipline. Tooling-only, zero product-runtime deps. (BR-42h)",
+  "version": "0.2.0",
+  "description": "Neutral, host-agnostic code-work / PR-workflow tooling for AI dev: a homogeneous `harness <verb>` method layer (branch/scope/verify/test/debug/review/brainstorm/plan), the native superpowers replacement. Tooling-only, zero product-runtime deps. (BR-42h)",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -22,6 +22,7 @@
   },
   "files": [
     "dist",
+    "skills",
     "README.md",
     "LICENSE"
   ],
@@ -33,6 +34,6 @@
   "devDependencies": {
     "@types/node": "^20.12.0",
     "typescript": "5.4.5",
-    "vitest": "4.0.18"
+    "vitest": "4.1.0"
   }
 }

package/skills/adopt/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: adopt
+description: Use when bringing the harness method to a NEW or non-sentropic repo — maps the repo's conventions into a harness profile so the same scope/branch/verify kernel applies anywhere.
+---
+
+# harness/adopt
+
+Native repo-onboarding. The harness engine (parser, C1/C2 checks, verify) is generic; all repo-specific
+policy is DATA in a profile. `adopt` maps a foreign repo onto that SPI so the method runs unchanged.
+
+## Steps
+
+1. **Scaffold** — `harness init [--profile sentropic|stub] [--json]` prints a profile descriptor. Save it
+   as `harness.profile.json` at the repo root and edit it to fit:
+   - `forbiddenPathDefaults` — globs forbidden unless a BRANCH.md explicitly Allows them.
+   - `exceptionIdPattern` — the grammar of a valid scope-exception id (e.g. `^BR\d+-EX\d+$`).
+   - `conditionalRequiresException` — whether a Conditional path needs a matching declared exception.
+   - `branchMatch` — `exact` or `prefix` for the C1 branch check.
+2. **Map the repo's reality** — translate the repo's conventions, not sentropic's: which paths are
+   off-limits, what its BRANCH.md grammar is (or whether one must be introduced), the command runner
+   (`make` vs `npm`/`nx`), and the environment data-lifecycle (which envs are disposable vs protected).
+3. **Audit** — `harness audit --staged-files "<changed files>" --branch-md <path> --json` diffs the repo
+   against the active profile and emits a `VerificationRun (static)` listing drift: forbidden touches,
+   undeclared (unknown) paths, missing scope declaration.
+4. **Wire** — add a `scope-check`/`verify` step to the repo's pre-commit or CI using the profile, so the
+   method is enforced, not just documented.
+
+## Principle
+
+A second `stub` profile diverging from `sentropic` on a checked dimension is the proof-of-genericity:
+the same kernel yields different, correct verdicts per profile. Adoption succeeds when a third repo can
+declare its OWN profile and the unchanged engine governs it.

package/skills/brainstorm/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: brainstorm
+description: Use before any creative/design work (a feature, a package, an evolution) — explores intent and design via the spec-ladder with multi-peer adversarial review BEFORE implementation.
+---
+
+# harness/brainstorm
+
+Native sentropic ideation. Stronger than a single-pass brainstorm: it climbs the **spec-ladder** and
+gates each design step with **≥2 independent adversarial peers** and **batched** owner decisions.
+
+Open the act: `harness brainstorm "<topic>" [--peers <n>] [--ladder study|vol|evol]` (records a WorkEvent).
+
+## The spec-ladder
+
+Pick the rung that matches the uncertainty, write the artifact under `spec/`:
+
+- **STUDY** (`SPEC_STUDY_<TOPIC>.md`) — open question, options, trade-offs. No commitment yet.
+- **VOL** (volition) — the chosen direction + rationale, still reversible.
+- **EVOL** (`SPEC_EVOL_<TOPIC>.md`) — the committed design with numbered decisions (D1…Dn) ready to plan.
+
+Don't skip rungs for a genuinely open problem; don't over-ceremony a reversible one.
+
+## Multi-peer adversarial review (the differentiator)
+
+Before presenting decisions, get **≥2 independent reviews from distinct angles** (e.g. Opus 4.8 + Codex
+5.5-xhigh, or distinct lenses: correctness / risk / user-value). Reconcile divergences explicitly — a
+lone reviewer rationalises; a panel surfaces failure modes. Reversible calls: decide solo. Blocking /
+irreversible calls: escalate.
+
+## Batched decisions
+
+Present owner decisions as a **clean full dossier (never a delta)**, THEN ask in **lots of ≤4** questions.
+Each question carries its own context inline (source + stakes + consequence) — an id like "D5" alone
+carries no meaning. Once answered, treat all answers final; do re-examination in prose, don't re-poll.
+
+## Done
+
+A ladder artifact exists, peers reconciled, decisions captured. Hand off to `harness/plan` to turn the
+EVOL decisions into BRANCH.md lots.

package/skills/debug/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: debug
+description: Use on any bug, test failure, or unexpected behaviour BEFORE proposing a fix — runs the generic evidence-first root-cause loop.
+---
+
+# harness/debug
+
+Native sentropic debugging. Open it with `harness debug "<symptom>"` (records a WorkEvent), then run the
+loop. No fix is proposed before the root cause is proven by evidence.
+
+## The loop
+
+1. **Reproduce** — a deterministic, minimal repro. If you can't reproduce it, you can't fix it.
+2. **Evidence** — gather facts with the tools, never assume: `make logs-<service>`, `make db-query
+   QUERY="…"`, container state (`make ps`), `grep`/`diff`. Read the actual error, the actual state.
+3. **One hypothesis** — the single most-likely cause that the evidence supports. Write it down.
+4. **One fix** — the smallest change that addresses THAT cause. No shotgun edits, no "while I'm here".
+5. **Re-observe** — rerun the repro. Confirm the symptom is gone AND the evidence changed as predicted.
+6. **Regression test** — promote the repro into a test (`harness/test`) so it can't silently return.
+
+## Rules
+
+- No "probably" / "maybe" / "should be" — verify with a tool before asserting. A claim without evidence
+  is a guess.
+- Change ONE thing at a time; if the symptom persists, revert it before trying the next.
+- A failing assertion is data, not noise — read the diff, don't loosen the assertion.
+- Live surfaces (UI/stream/API/extension) have a dev-lane bootstrap (Playwright/probe targets); use it to
+  observe the real behaviour rather than reasoning in the abstract.
+
+## Done
+
+Root cause named + evidenced, minimal fix in place, repro green as a regression test, no collateral
+change. Hand verification to `harness verify`.

package/skills/plan/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: plan
+description: Use when you have a spec/decisions and need an executable plan — writes a lot-based BRANCH.md from the template and completes with track for realization state.
+---
+
+# harness/plan
+
+Native sentropic planning. Turns an EVOL spec's decisions into an executable, scoped `BRANCH.md`. Open it
+with `harness plan "<spec>" [--lots <n>]` (records a WorkEvent; harness writes BRANCH.md, then
+`track branch import` indexes it).
+
+## Write BRANCH.md from the template
+
+Use `plan/BRANCH_TEMPLATE.md` strictly — checkboxes only, no prose, no `###`. First iteration must be
+detailed:
+
+- **Objective** + **Scope / Guardrails**.
+- **Branch Scope Boundaries**: `Allowed` / `Forbidden` / `Conditional` paths (default forbidden: `Makefile`,
+  `docker-compose*.yml`, `.cursor/rules/**`). Exceptions via `BRxx-EXn` (reason + impact + rollback).
+- **Lot-based plan**: each lot is one logical change with a file-level test list and a lot gate.
+- **Feedback Loop** for blockers/decisions.
+
+## Lots & commit discipline
+
+- One logical change per lot/commit; max ~10–15 files and **under 150 lines** per commit.
+- Selective staging (`git add <files>` — never `git add .`); commit via `make commit MSG="type: …"`.
+- Update `BRANCH.md` checkboxes WITHIN each commit.
+- Multi-need work → multi-branch with a root `PLAN.md` (waves ≤4 orthogonal branches).
+
+## Completes with track
+
+harness OWNS the BRANCH.md (the master plan artifact) and EMITS `WorkEvent`s; **track** ingests them and
+owns the realization state — Items, links, Decisions, acceptance, and the AWAITED / DROPPED / DONE / TO-DO
+projections. Don't duplicate status in BRANCH.md prose — let track project it. Execute lots in order
+autonomously; only interrupt for a real fork or blocker.

package/skills/review/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: review
+description: Use when completing a feature, a design step, or before merging — runs a ≥2-peer consensus review and reconciles the findings, instead of a single rubber-stamp pass.
+---
+
+# harness/review
+
+Native sentropic code/design review. Stronger than a single review: **≥2 independent peers**, distinct
+lenses, reconciled. Open it with `harness review "<target>" --consensus [--peers <n>]` (records a
+WorkEvent).
+
+## Consensus protocol
+
+1. **Dispatch ≥2 independent peers** on the SAME diff/design — ideally different models or angles
+   (e.g. Opus 4.8 + Codex 5.5-xhigh), each blind to the others.
+2. **Distinct lenses** when a finding can fail in more than one way: correctness · security · performance ·
+   does-it-actually-reproduce. Diversity catches what redundancy can't.
+3. **Refute by default** — each peer tries to REFUTE the change / a claimed finding. A finding survives
+   only if it withstands the skeptics; a kill needs a majority.
+4. **Reconcile** — merge findings, surface disagreements explicitly, classify accept / reject / defer with
+   a one-line rationale each. Don't average; adjudicate.
+
+## Receiving review (technical rigor, not performative agreement)
+
+Before implementing a suggestion, verify it. If feedback is unclear or technically questionable, push back
+with evidence rather than complying blindly. Apply what's correct; refute what's wrong; ask when genuinely
+ambiguous.
+
+## Severity & gate
+
+Findings that gate a lot escalate to a `VerificationRun` (`harness verify --category static`). Narrative
+findings stay a `WorkEvent`. Blocking findings must be resolved before merge; non-blocking are logged in
+`BRANCH.md` `## Feedback Loop` with owner + status.

package/skills/test/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: test
+description: Use when adding or evolving tests for a feature/bugfix — applies the sentropic test-pyramid, scoped-test loop, environment isolation, and AI-flaky policy.
+---
+
+# harness/test
+
+Native sentropic testing discipline (NOT "tdd" ritual — the act is `test`). Open it with
+`harness test [<scope>] [--category unit|integration|e2e] [--watch]` (records a WorkEvent), then follow
+the loop.
+
+## Pyramid
+
+70% unit · 20% integration · 10% e2e. Test behaviour, not implementation — query by user-visible
+elements (text/role/label) over test ids. Names: "should <behaviour> when <condition>".
+
+## Scoped-test loop (while developing)
+
+Run ONLY the test under evolution, on a dedicated test ENV — never `dev`:
+
+- API: `make test-api-<suite> SCOPE=tests/<file>.spec.ts ENV=test-<slug>`
+- UI: `make test-ui SCOPE=tests/<file>.spec.ts ENV=test-<slug>`
+- E2E: `make test-e2e E2E_SPEC=tests/<file>.spec.ts API_PORT=… UI_PORT=… MAILDEV_UI_PORT=… ENV=e2e-<slug>`
+
+Full gates only at end of lot/branch: `make test-api`, `make test-ui`, `make clean test-e2e`.
+
+## Environment isolation (MANDATORY)
+
+- NEVER run test campaigns on `ENV=dev` — afterEach hooks purge real data.
+- Branch tests live in the isolated worktree on `ENV=test-<slug>` / `ENV=e2e-<slug>`; `ENV` is the LAST
+  make argument.
+- NEVER add timeouts to make a flaky e2e pass — a timeout failure is a real bug (bad selector, race,
+  regression). UI waits are <2s except AI generation.
+
+## AI-flaky allowlist (non-blocking)
+
+Only accept non-systematic provider/network/model nondeterminism, and only with ≥1 success on the same
+commit + command. Record the exact command + failing file + failure signature in `BRANCH.md` and get
+explicit user sign-off before merge. Everything else is blocking.
+
+## CI is authority
+
+CI was green on main → any branch failure IS a branch problem; never claim "pre-existing". Decide:
+evolution (adapt the test) or regression (fix the code). Local-green / CI-red → trust CI.