harnery 0.38.0 → 0.40.0

package/dist/lib/browser/tiling.d.ts

@@ -87,4 +87,34 @@ export declare function bandsCoveringRects(allBands: ReadonlyArray<{
     width: number;
     height: number;
 }>, maxExtra?: number): number[];
+/** All native-pixel candidates, before any per-pack allocation or cropping. */
+export declare function reviewCandidateRects(args: {
+    width: number;
+    height: number;
+    bandHeight: number;
+    overlap: number;
+    atoms?: VisualAtom[];
+    scopes?: Array<{
+        selector: string;
+        rects: Array<{
+            label: string;
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+    }>;
+}): Array<{
+    id: string;
+    index: number;
+    label: string;
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    scope?: string;
+    gate_hits: [];
+}>;
 //# sourceMappingURL=tiling.d.ts.map

package/dist/lib/browser/tiling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tiling.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/tiling.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;IACvC,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,CAAC,EAAE,MAAM,CAAC;IACV,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD,6DAA6D;AAC7D,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CActF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EAAE,EACnB,IAAI,EAAE,WAAW,GAChB;IACD,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CA+CA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5E,KAAK,EAAE,UAAU,EAAE,EACnB,IAAI,EAAE,WAAW,GAChB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAU/E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EAChF,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7E,QAAQ,SAAK,GACZ,MAAM,EAAE,CAiBV"}
+{"version":3,"file":"tiling.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/tiling.ts"],"names":[],"mappings":"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"}

package/dist/lib/browser/tiling.js

@@ -144,3 +144,41 @@ export function bandsCoveringRects(allBands, keptCount, rects, maxExtra = 50) {
     }
     return out;
 }
+/** All native-pixel candidates, before any per-pack allocation or cropping. */
+export function reviewCandidateRects(args) {
+    const opts = { bandHeight: args.bandHeight, overlap: args.overlap };
+    const bands = args.atoms?.length
+        ? snappedBandRects(0, args.height, 0, args.width, args.atoms, opts).rects
+        : Array.from({
+            length: Math.ceil(Math.max(0, args.height - args.bandHeight) /
+                Math.max(1, args.bandHeight - args.overlap)) + 1,
+        }, (_, i) => {
+            const y = i * Math.max(1, args.bandHeight - args.overlap);
+            return { x: 0, y, width: args.width, height: Math.min(args.bandHeight, args.height - y) };
+        });
+    const out = bands.map((r, i) => ({
+        id: `band-${i + 1}`,
+        index: i,
+        label: `band ${i + 1}`,
+        rect: { x: r.x, y: r.y, width: r.width, height: r.height },
+        gate_hits: [],
+    }));
+    for (const [scopeIndex, scope] of (args.scopes ?? []).entries()) {
+        const expanded = scope.rects.flatMap((r) => bandOversizedRect(r, args.atoms ?? [], opts));
+        for (const [i, r] of expanded.entries()) {
+            const x = Math.max(0, Math.round(r.x)), y = Math.max(0, Math.round(r.y));
+            const width = Math.min(Math.round(r.width), args.width - x), height = Math.min(Math.round(r.height), args.height - y);
+            if (width <= 0 || height <= 0)
+                continue;
+            out.push({
+                id: `scope-${scopeIndex + 1}-${i + 1}`,
+                index: out.length,
+                label: r.label,
+                scope: scope.selector,
+                rect: { x, y, width, height },
+                gate_hits: [],
+            });
+        }
+    }
+    return out;
+}

package/dist/lib/docs-metadata-managed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-metadata-managed.d.ts","sourceRoot":"","sources":["../../src/lib/docs-metadata-managed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAwC,MAAM,uBAAuB,CAAC;AAMpG;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUhE;AAmBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,OAAO,GACtB,gBAAgB,GAAG,IAAI,CAczB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,OAAO,GACtB,OAAO,CAIT"}
+{"version":3,"file":"docs-metadata-managed.d.ts","sourceRoot":"","sources":["../../src/lib/docs-metadata-managed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAwC,MAAM,uBAAuB,CAAC;AAMpG;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAahE;AAmBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,OAAO,GACtB,gBAAgB,GAAG,IAAI,CAczB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,OAAO,GACtB,OAAO,CAIT"}

package/dist/lib/docs-metadata-managed.js

@@ -15,7 +15,10 @@ export function isExcludedDocsMetadataPath(path) {
         // Dashboard surfaces render from copies of other repositories' documents.
         /(?:^|\/)content\/dashboards\//.test(rel) ||
         /(?:^|\/)docs\/shopify\/admin-api\//.test(rel) ||
-        /(?:^|\/)docs\/templates\//.test(rel));
+        // Template skeletons carry placeholder frontmatter by design. Hosts keep
+        // them under docs/templates/ or another documentation root such as
+        // meta-docs/templates/, so match the directory name rather than one root.
+        /(?:^|\/)templates\//.test(rel));
 }
 function lifecycleType(path) {
     const rel = normalized(path);

package/dist/lib/identities/assume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assume.d.ts","sourceRoot":"","sources":["../../../src/lib/identities/assume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAuBH,MAAM,MAAM,uBAAuB,GAC/B,eAAe,GACf,iBAAiB,GACjB,sBAAsB,GACtB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,GACb,mBAAmB,CAAC;AAExB,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,uBAAuB;gBAA7B,IAAI,EAAE,uBAAuB,EAC7C,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+DAA+D;IAC/D,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAOD;+EAC+E;AAC/E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAa,EAClB,mBAAmB,GAAE,WAAW,CAAC,MAAM,CAAa,GACnD,gBAAgB,GAAG,IAAI,CA6BzB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAyCT;AAyED,gEAAgE;AAChE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,oBAAoB,CAkHtB"}
+{"version":3,"file":"assume.d.ts","sourceRoot":"","sources":["../../../src/lib/identities/assume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAuBH,MAAM,MAAM,uBAAuB,GAC/B,eAAe,GACf,iBAAiB,GACjB,sBAAsB,GACtB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,GACb,mBAAmB,CAAC;AAExB,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,uBAAuB;gBAA7B,IAAI,EAAE,uBAAuB,EAC7C,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+DAA+D;IAC/D,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAOD;+EAC+E;AAC/E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAa,EAClB,mBAAmB,GAAE,WAAW,CAAC,MAAM,CAAa,GACnD,gBAAgB,GAAG,IAAI,CA6BzB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAyCT;AA0ED,gEAAgE;AAChE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,oBAAoB,CAyHtB"}

package/dist/lib/identities/assume.js

@@ -179,6 +179,8 @@ function adapterOf(platform) {
         return "cursor";
     if (platform === "codex")
         return "codex";
+    if (platform === "openclaw")
+        return "openclaw";
     return "claude-code";
 }
 /** Assume `target` for one live main session. Safe to retry. */
@@ -238,11 +240,15 @@ export function assumeIdentity(coordRoot, instanceId, target, opts) {
                 reclaimed_instance_id: reclaimedInstanceId,
             };
         }
+        const adapter = adapterOf(hb.platform);
+        if (adapter === "openclaw") {
+            throw new IdentityAssumeError("not_session", "identity assumption is unavailable for observer-only OpenClaw generations");
+        }
         const emitted = recordLiveIdentityChangeV3({
             coordRoot,
             owner: instanceId,
             nativeSessionId: hb.native_session_id ?? hb.session_id,
-            adapter: adapterOf(hb.platform),
+            adapter,
             name: identity.name,
             identityId: identity.agent_id,
         });

package/dist/lib/instructions/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/lib/instructions/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,sEAAsE;AACtE,eAAO,MAAM,aAAa,WAAW,CAAC;AACtC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,GAAG,EAAE,OAAO,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,WAAoE,GAC3E,MAAM,CAgHR;AAID,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAsVD,eAAO,MAAM,MAAM,EAAE,aAAa,EAiDjC,CAAC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/lib/instructions/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,sEAAsE;AACtE,eAAO,MAAM,aAAa,WAAW,CAAC;AACtC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,GAAG,EAAE,OAAO,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,WAAoE,GAC3E,MAAM,CAiHR;AAID,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAsVD,eAAO,MAAM,MAAM,EAAE,aAAa,EAiDjC,CAAC"}

package/dist/lib/instructions/templates.js

@@ -128,6 +128,7 @@ Use it for anything future-you or a peer will need to pick up your thread.
 and other untracked files that must survive a session, create a managed workspace
 with \`${b} artifacts create <slug> --purpose "<why>"\`. Write files under the
 returned path, then run \`${b} artifacts release <id>\` when active work is done.
+After review, use \`${b} artifacts discard <id> --reason "<why no longer needed>"\` for disposable or superseded evidence: it releases ownership and shortens retention to at most 60 minutes (\`--minutes\` overrides). Keep unresolved failures, handoffs, final evidence, and files awaiting review; use a hold when needed. A passing check cannot establish whether another reader needs the files, so the reviewing agent decides. For known short-lived work, \`${b} artifacts create --minutes <n>\` sets the initial window.
 Do not create a repo-root temp directory; \`${b} artifacts clean\` previews
 expired cleanup and requires \`--yes\` to delete anything.
 

package/dist/lib/local-file-url.d.ts

@@ -2,6 +2,18 @@
 export declare const DEFAULT_WEB_PORT = 4276;
 /** Cookie-isolated host for navigable repo files. */
 export declare const FILES_ORIGIN_HOST = "harnery-files.localhost";
+/**
+ * Percent-encode one URL component so the finished URL is safe as a bare
+ * Markdown destination.
+ *
+ * encodeURIComponent leaves parentheses raw, and a raw ")" ends a `[text](url)`
+ * destination early. The alternative is the angle-bracket destination form,
+ * which is valid CommonMark but is not implemented by every renderer, and one
+ * that skips it can style the text as a link while dropping the href, leaving
+ * something that looks clickable and does nothing. These URLs are written into
+ * Markdown for humans to click, so encode the parentheses instead.
+ */
+export declare function encodeLinkSafeComponent(value: string): string;
 /** Encode each repo-path segment while preserving slash-based URL resolution. */
 export declare function encodedRepoPath(relPath: string): string;
 export declare function localFilesOriginUrl(relPath: string, port?: number | string, protocol?: string): string;

package/dist/lib/local-file-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-file-url.d.ts","sourceRoot":"","sources":["../../src/lib/local-file-url.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAE3D,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,GAAG,MAAyB,EACxC,QAAQ,SAAU,GACjB,MAAM,CAGR;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,GAAG,MAAyB,GACvC,MAAM,CAER"}
+{"version":3,"file":"local-file-url.d.ts","sourceRoot":"","sources":["../../src/lib/local-file-url.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,GAAG,MAAyB,EACxC,QAAQ,SAAU,GACjB,MAAM,CAGR;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,GAAG,MAAyB,GACvC,MAAM,CAER"}

package/dist/lib/local-file-url.js

@@ -2,13 +2,27 @@
 export const DEFAULT_WEB_PORT = 4276;
 /** Cookie-isolated host for navigable repo files. */
 export const FILES_ORIGIN_HOST = "harnery-files.localhost";
+/**
+ * Percent-encode one URL component so the finished URL is safe as a bare
+ * Markdown destination.
+ *
+ * encodeURIComponent leaves parentheses raw, and a raw ")" ends a `[text](url)`
+ * destination early. The alternative is the angle-bracket destination form,
+ * which is valid CommonMark but is not implemented by every renderer, and one
+ * that skips it can style the text as a link while dropping the href, leaving
+ * something that looks clickable and does nothing. These URLs are written into
+ * Markdown for humans to click, so encode the parentheses instead.
+ */
+export function encodeLinkSafeComponent(value) {
+    return encodeURIComponent(value).replace(/[()]/g, (char) => (char === "(" ? "%28" : "%29"));
+}
 /** Encode each repo-path segment while preserving slash-based URL resolution. */
 export function encodedRepoPath(relPath) {
     return relPath
         .replace(/^\/+/, "")
         .split("/")
         .filter(Boolean)
-        .map((segment) => encodeURIComponent(segment))
+        .map((segment) => encodeLinkSafeComponent(segment))
         .join("/");
 }
 export function localFilesOriginUrl(relPath, port = DEFAULT_WEB_PORT, protocol = "http:") {
@@ -16,5 +30,5 @@ export function localFilesOriginUrl(relPath, port = DEFAULT_WEB_PORT, protocol =
     return `${protocol}//${FILES_ORIGIN_HOST}${portPart}/${encodedRepoPath(relPath)}`;
 }
 export function localFileViewerUrl(relPath, port = DEFAULT_WEB_PORT) {
-    return `http://localhost:${port}/files?path=${encodeURIComponent(relPath)}`;
+    return `http://localhost:${port}/files?path=${encodeLinkSafeComponent(relPath)}`;
 }

package/dist/lib/tunnel/state.d.ts

@@ -27,15 +27,30 @@ export interface TunnelState {
 }
 export declare function readConfig(): TunnelConfig;
 export declare function writeConfig(cfg: TunnelConfig): void;
-export declare function readState(name?: string): TunnelState | null;
-export declare function writeState(state: TunnelState): void;
-export declare function clearState(name?: string): void;
+export declare function readState(name?: string, root?: string): TunnelState | null;
+export declare function writeState(state: TunnelState, root?: string): void;
+export declare function clearState(name?: string, root?: string): void;
 /**
  * Every persisted tunnel instance, newest-started first. Reads every
  * `state*.json` under `.cache/tunnel/`; tolerates missing/corrupt files.
  */
-export declare function listStates(): TunnelState[];
+export declare function listStates(root?: string): TunnelState[];
 export declare function isProcessAlive(pid: number): boolean;
+export type ProcessAliveCheck = (pid: number) => boolean;
+/** True when both the local gate and its provider-side process are live. */
+export declare function isTunnelStateLive(state: TunnelState, processAlive?: ProcessAliveCheck): boolean;
+/**
+ * Newest live tunnel that serves `vhost` on the requested local web port.
+ *
+ * The port alone does not identify a tunnel. Several tunnels can forward to one
+ * upstream port and be told apart only by the Host header they send, and a
+ * server that routes on Host then serves each of them a different site. Picking
+ * by port alone returns whichever such tunnel started last, so a caller that
+ * builds a URL for one site can hand back a host that serves another and every
+ * link 400s. Matching the vhost too keeps the returned tunnel the one that
+ * actually serves the caller's origin.
+ */
+export declare function findLiveTunnelForOrigin(port: number, vhost: string, root?: string, processAlive?: ProcessAliveCheck): TunnelState | null;
 /**
  * Ensure cloudflared is on PATH or installed at ~/.local/bin/cloudflared.
  * Auto-downloads on Linux; throws on other platforms with brew hint.

package/dist/lib/tunnel/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/lib/tunnel/state.ts"],"names":[],"mappings":"AAuBA,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAW1C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAG9E;AAgBD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAOD,wBAAgB,UAAU,IAAI,YAAY,CAWzC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAEnD;AAED,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAyB,GAAG,WAAW,GAAG,IAAI,CAQ7E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAyB,GAAG,IAAI,CAGhE;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,WAAW,EAAE,CAW1C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAuB1C"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/lib/tunnel/state.ts"],"names":[],"mappings":"AAwBA,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAW1C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAG9E;AAgBD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAOD,wBAAgB,UAAU,IAAI,YAAY,CAWzC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAEnD;AAED,wBAAgB,SAAS,CACvB,IAAI,GAAE,MAAyB,EAC/B,IAAI,GAAE,MAAsB,GAC3B,WAAW,GAAG,IAAI,CAQpB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,MAAsB,GAAG,IAAI,CAEjF;AAED,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAyB,EAAE,IAAI,GAAE,MAAsB,GAAG,IAAI,CAG9F;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAsB,GAAG,WAAW,EAAE,CAWtE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;AAEzD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,YAAY,GAAE,iBAAkC,GAC/C,OAAO,CAKT;AAeD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAsB,EAC5B,YAAY,GAAE,iBAAkC,GAC/C,WAAW,GAAG,IAAI,CASpB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAuB1C"}

package/dist/lib/tunnel/state.js

@@ -1,11 +1,12 @@
-// Tunnel config + state persistence + provider helpers. Lives under
+// Tunnel config + state persistence + provider helpers. Commands default to
 // <cwd>/.cache/tunnel/; gitignored, so the allowlist is per-machine.
 import { execSync } from "node:child_process";
 import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
 import { resolve } from "node:path";
-// Inline cachePath: tunnel state under <cwd>/.cache/tunnel/.
-function cachePath(tool, filename) {
-    const dir = resolve(process.cwd(), ".cache", tool);
+// Tunnel state lives under <root>/.cache/tunnel/. Root defaults to cwd for the
+// command surface and can be supplied by callers that already resolved a repo.
+function cachePath(tool, filename, root = process.cwd()) {
+    const dir = resolve(root, ".cache", tool);
     if (!existsSync(dir))
         mkdirSync(dir, { recursive: true });
     return resolve(dir, filename);
@@ -65,8 +66,8 @@ export function readConfig() {
 export function writeConfig(cfg) {
     writeFileSync(cachePath("tunnel", CONFIG_FILE), JSON.stringify(cfg, null, 2));
 }
-export function readState(name = DEFAULT_INSTANCE) {
-    const p = cachePath("tunnel", stateFile(name));
+export function readState(name = DEFAULT_INSTANCE, root = process.cwd()) {
+    const p = cachePath("tunnel", stateFile(name), root);
     if (!existsSync(p))
         return null;
     try {
@@ -76,11 +77,11 @@ export function readState(name = DEFAULT_INSTANCE) {
         return null;
     }
 }
-export function writeState(state) {
-    writeFileSync(cachePath("tunnel", stateFile(state.name)), JSON.stringify(state, null, 2));
+export function writeState(state, root = process.cwd()) {
+    writeFileSync(cachePath("tunnel", stateFile(state.name), root), JSON.stringify(state, null, 2));
 }
-export function clearState(name = DEFAULT_INSTANCE) {
-    const p = cachePath("tunnel", stateFile(name));
+export function clearState(name = DEFAULT_INSTANCE, root = process.cwd()) {
+    const p = cachePath("tunnel", stateFile(name), root);
     if (existsSync(p))
         unlinkSync(p);
 }
@@ -88,8 +89,8 @@ export function clearState(name = DEFAULT_INSTANCE) {
  * Every persisted tunnel instance, newest-started first. Reads every
  * `state*.json` under `.cache/tunnel/`; tolerates missing/corrupt files.
  */
-export function listStates() {
-    const dir = resolve(process.cwd(), ".cache", "tunnel");
+export function listStates(root = process.cwd()) {
+    const dir = resolve(root, ".cache", "tunnel");
     if (!existsSync(dir))
         return [];
     const out = [];
@@ -97,7 +98,7 @@ export function listStates() {
         const name = nameFromStateFile(file);
         if (name === null)
             continue;
-        const state = readState(name);
+        const state = readState(name, root);
         if (state)
             out.push(state);
     }
@@ -112,6 +113,45 @@ export function isProcessAlive(pid) {
         return false;
     }
 }
+/** True when both the local gate and its provider-side process are live. */
+export function isTunnelStateLive(state, processAlive = isProcessAlive) {
+    if (!processAlive(state.gate_pid))
+        return false;
+    if (state.provider === "tailscale")
+        return true;
+    const providerPid = state.cloudflared_pid ?? state.provider_pid;
+    return typeof providerPid === "number" && processAlive(providerPid);
+}
+function tunnelTargetPort(state) {
+    const value = /^[a-z][a-z\d+.-]*:\/\//i.test(state.target)
+        ? state.target
+        : `http://${state.target}`;
+    try {
+        const url = new URL(value);
+        if (url.port)
+            return Number.parseInt(url.port, 10);
+        return url.protocol === "https:" ? 443 : 80;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Newest live tunnel that serves `vhost` on the requested local web port.
+ *
+ * The port alone does not identify a tunnel. Several tunnels can forward to one
+ * upstream port and be told apart only by the Host header they send, and a
+ * server that routes on Host then serves each of them a different site. Picking
+ * by port alone returns whichever such tunnel started last, so a caller that
+ * builds a URL for one site can hand back a host that serves another and every
+ * link 400s. Matching the vhost too keeps the returned tunnel the one that
+ * actually serves the caller's origin.
+ */
+export function findLiveTunnelForOrigin(port, vhost, root = process.cwd(), processAlive = isProcessAlive) {
+    return (listStates(root).find((state) => tunnelTargetPort(state) === port &&
+        state.vhost === vhost &&
+        isTunnelStateLive(state, processAlive)) ?? null);
+}
 /**
  * Ensure cloudflared is on PATH or installed at ~/.local/bin/cloudflared.
  * Auto-downloads on Linux; throws on other platforms with brew hint.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnery",
-  "version": "0.38.0",
+  "version": "0.40.0",
   "description": "Multi-agent coordination for AI coding agents - Claude Code, Cursor, and Codex.",
   "license": "MIT",
   "author": "Ryan Kelly",
@@ -238,16 +238,17 @@
   "packageManager": "bun@1.4.0",
   "scripts": {
     "build": "npm run clean && tsc -p tsconfig.build.json && node scripts/rewrite-dts-extensions.mjs",
+    "build:openclaw-plugin": "mkdir -p openclaw-plugin/dist && bun build openclaw-plugin/src/index.ts openclaw-plugin/src/record-worker.ts --target=node --format=esm --external openclaw --outdir openclaw-plugin/dist --entry-naming '[name].js' && cp openclaw-plugin/package.json openclaw-plugin/openclaw.plugin.json openclaw-plugin/dist/",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run build",
     "typecheck": "bun x tsc --noEmit",
-    "lint": "bun x @biomejs/biome check src",
+    "lint": "bun x @biomejs/biome check src openclaw-plugin",
     "check:portability": "bun run scripts/check-portability.ts",
     "check:public-surface": "bun run scripts/check-public-surface.ts",
     "check:layering": "bun run scripts/check-layering.ts",
     "probe:supervisor-budget": "bun run scripts/probe-supervisor-budget.ts",
-    "lint:fix": "bun x @biomejs/biome check --write src",
-    "format": "bun x @biomejs/biome format --write src",
+    "lint:fix": "bun x @biomejs/biome check --write src openclaw-plugin",
+    "format": "bun x @biomejs/biome format --write src openclaw-plugin",
     "test": "bun run scripts/test.mjs",
     "test:list": "bun run scripts/test.mjs --list",
     "test:web": "cd web && bun install && bun test",
@@ -259,6 +260,8 @@
     "verify:contracts": "bun run scripts/sync-verified-contracts.ts",
     "verify:contracts:check": "bun run scripts/sync-verified-contracts.ts --check",
     "generate:event-v3": "bun run scripts/generate-event-v3-contract.ts",
+    "fixtures:openclaw:intake": "bun run openclaw-plugin/scripts/intake-fixtures.ts",
+    "test:openclaw-node24": "node openclaw-plugin/scripts/test-node24.mjs",
     "check:event-v3": "bun run scripts/generate-event-v3-contract.ts --check && bun run scripts/check-event-v3-reader-boundary.ts",
     "generate:docs-metadata-v2": "bun run scripts/generate-docs-metadata-v2-schema.ts",
     "check:docs-metadata-v2": "bun run scripts/generate-docs-metadata-v2-schema.ts --check"

package/schemas/config.schema.json

@@ -308,6 +308,37 @@
         }
       }
     },
+    "hooks": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Optional project-owned hook extensions. User-global values cannot enable project executables.",
+      "properties": {
+        "promptContext": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["enabled"],
+          "description": "Run scripts/hooks/harness/extensions/prompt-context through the normalized prompt hook. Disabled by default and project config only.",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "timeoutMs": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 120000,
+              "default": 15000
+            },
+            "maxOutputBytes": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 4194304,
+              "default": 65536
+            }
+          }
+        }
+      }
+    },
     "instructions": {
       "type": "object",
       "additionalProperties": false,
@@ -345,7 +376,7 @@
     "backup": {
       "type": "object",
       "additionalProperties": false,
-      "description": "`harn backup` (restic) defaults. Env overrides: HARNERY_RESTIC_REPO, HARNERY_RESTIC_PASSWORD_FILE. `harn backup` is manual (init/snapshot/prune/...); there is no auto-snapshot scheduler.",
+      "description": "`harn backup` (restic) defaults. Env overrides: HARNERY_RESTIC_REPO, HARNERY_RESTIC_PASSWORD_FILE. Set backup.schedule to run a non-blocking, freshness-gated snapshot from SessionStart.",
       "properties": {
         "repo": {
           "type": "string",
@@ -353,7 +384,43 @@
         },
         "password_file": {
           "type": "string",
-          "description": "File holding the restic repo password. Default: ~/.config/harnery/restic-password (autogenerated on `harn backup init`)."
+          "description": "File holding the restic repo password. Relative paths resolve from the coordination root. Default: ~/.config/harnery/restic-password (autogenerated on `harn backup init`)."
+        },
+        "include": {
+          "type": "array",
+          "default": [],
+          "items": { "type": "string", "minLength": 1 },
+          "description": "Extra .harnery-relative paths to add to the catalog-derived default snapshot set."
+        },
+        "exclude": {
+          "type": "array",
+          "default": [],
+          "items": { "type": "string", "minLength": 1 },
+          "description": "Catalog family IDs or .harnery-relative paths to remove from the snapshot set."
+        },
+        "max_bytes": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 52428800,
+          "description": "Maximum logical bytes selected by snapshot before --allow-large is required."
+        },
+        "schedule": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["if_stale"],
+          "description": "Optional SessionStart snapshot schedule. Absence disables scheduled snapshots.",
+          "properties": {
+            "if_stale": {
+              "type": "string",
+              "pattern": "^[1-9][0-9]*(ms|s|m|h|d)$",
+              "description": "Run only when this host's newest snapshot is older than the duration, such as 24h."
+            },
+            "tags": {
+              "type": "array",
+              "default": [],
+              "items": { "type": "string", "minLength": 1 }
+            }
+          }
         },
         "keep_daily": {
           "type": "integer",