persona-harness 0.8.32 → 0.8.34

package/README.md

@@ -87,6 +87,61 @@ A workflow + evidence CLI (`ph`) with an optional OpenCode plugin, for Java/Spri
 - can block completion when required reports or evidence for defined gates are
   missing.
 
+Persona Harness exposes two deliberately separate tracks:
+
+- **Workflow Integrity** is the existing evidence and completion-gate product.
+- **Context Personalization (Experimental)** is a local, default-off path for
+  targeted convention guidance. When enabled in a project that has the
+  OpenCode plugin registered, it delivers one bounded Context block only after
+  a safe observed file target. It grants no completion authority.
+
+Context configuration is separate from legacy runtime guidance switches. A
+missing block stays disabled. An explicit `context.enabled` setting controls
+only the targeted Context adapter; it does not enable legacy runtime guidance,
+write configuration, or create workflow/evidence/authority state:
+
+```jsonc
+{
+  "context": {
+    "enabled": false,
+    "mode": "targeted",
+    "maxCapsules": 8,
+    "maxChars": 1600
+  }
+}
+```
+
+Only `targeted` is accepted. Invalid or unknown Context fields leave Context
+disabled with a bounded diagnostic; they do not inherit enablement from
+`features.runtimeInjection` or `features.projectPhilosophyInjection`.
+
+`ph context status` is available as a read-only local inspection of that
+configuration and an optional safe Team Profile. `ph context preview
+<target-file>` accepts a safe project-relative path without opening the target,
+then renders a deterministic local Context Envelope from product invariants,
+starter defaults, and any available Team or personal rules. It remains an
+inspection surface: it neither enables Context nor delivers to a host.
+`ph context explain <target-file>` renders the envelope's bounded selection,
+shadowing, resolution, budget, and digest metadata without exposing rule text.
+Both inspection commands are read-only: they do not enable Context, activate a
+host adapter, or create state. Bare `ph context init` remains a no-write
+preview. `ph context init --enable` creates only the minimal Context config in
+a fresh safe project; it refuses to overwrite an existing harness config and
+does not change legacy feature flags. `ph context doctor` reports the actual
+local configuration and Team Profile state, including the bundled OpenCode 1.x
+adapter. It cannot prove that a particular OpenCode session has loaded the
+project plugin.
+
+With Context enabled, the OpenCode adapter accepts only a safe observed
+project-relative target from a read or edit tool. It resolves the local
+envelope, rejects invalid/unsafe/budget-exceeding input without delivery, and
+prepends the selected bounded capsule content to the next user message for the
+same session. It suppresses the same digest until that session is compacted or
+deleted. It does not infer a target from the prompt, inject a full skill
+catalog, access the network, execute shell commands, or write workflow,
+evidence, or authority records. The adapter's actual behavior in a live
+OpenCode release remains a separate host-observation boundary.
+
 The optional runtime adapter also registers the bundled portable Persona-owned
 shared-skill catalog with OpenCode. Product ideas start with a one-question
 interview and explicit brief approval; adapters advise only and never create
@@ -198,15 +253,29 @@ Three-beat setup, gate, and goal-entry walkthrough: **[Quick Demo](docs/QUICK-DE
 From a source checkout, the commands have deliberately different scopes:
 
 ```bash
-npm test                    # packaged CLI smoke
-npm run test:unit           # full Vitest unit/integration suite
-npm run test:repository     # full repository contract: policy, docs, unit/integration, and clean-package checks
+npm test                    # source checkout: fast tests; installed tarball: CLI smoke
+npm run test:unit           # focused pure resolver/config/adapter tests
+npm run test:integration    # focused profile/runtime/package-policy integration
+npm run test:smoke          # build plus packaged CLI help smoke
+npm run test:package        # fresh tarball and installed-package contract
+npm run test:full           # complete repository/release contract
+npm run test:repository:parallel           # parallel-safe Vitest project
+npm run test:repository:resource-sensitive # isolated fixture-heavy Vitest project
+npm run test:repository:fast               # both PR test projects, sequentially for local use
+npm run test:repository     # full repository contract for release: policy, docs, all tests, and clean-package checks
 node scripts/verify-cooperative-finish-demo.mjs # exact packed-package Java/Spring Gradle/JUnit demo
 ```
 
-The required `Verify repository` workflow runs the full repository contract and
-the exact cooperative demo. These commands establish their named contracts; they
-do not certify generated application quality or external Finish authority.
+The required `Verify repository` aggregate waits for policy, typecheck, build,
+and both Vitest projects on pull requests. On `main` pushes it additionally
+requires the authoritative clean-package boundary, Linux source and installed
+package surfaces, and the exact cooperative demo. Release and publish workflows
+retain the full `test:repository` contract. These commands establish their
+named contracts; they do not certify generated application quality or external
+Finish authority.
+
+For the measured CI decision and operational failure modes, see [CI fast
+feedback troubleshooting](docs/troubleshooting/ci-fast-feedback.md).
 
 ## TDD Rail (opt-in)
 
@@ -289,12 +358,12 @@ command publishes a package, moves a channel, or consumes Finish authority.
 
 | Surface | Status | Evidence boundary |
 | --- | --- | --- |
-| Linux + OpenCode | Product: Node ^20.17.0 || >=22.9.0; source checks: Node 20.19.0 | Required Verify repository runs Linux Node 20.19.0 source-built, packed-tarball, and fresh local-tarball installed checks on pull requests and main pushes. The dispatch-only support matrix retains exact product-floor Linux Node 20.17.0 and 22.9.0 imports plus latest Linux Node 20, 22, and 24 on demand. |
+| Linux + OpenCode | Product: Node ^20.17.0 || >=22.9.0; source checks: Node 20.19.0 | Required Verify repository aggregates PR fast feedback and main package integration. Pull requests run policy, typecheck, build, and the two Vitest projects; main pushes additionally run Linux Node 20.19.0 source-built, packed-tarball, and fresh local-tarball installed checks. The dispatch-only support matrix retains exact product-floor Linux Node 20.17.0 and 22.9.0 imports plus latest Linux Node 20, 22, and 24 on demand. |
 | macOS + OpenCode | Manual limited smoke | The dispatch-only support matrix retains macOS Node 22 smoke only; this is not a promise of macOS Node 20/24 coverage. |
 | Windows | Unverified / nonblocking | No Windows matrix job or support claim. Lock identity device/inode behavior and stale-lock/concurrency conclusions are not measured or verified. |
 | Codex adapter | Planned | No current Codex adapter or Codex product evidence; this is a planned adapter only. |
 
-Automatic CI boundary: Verify repository is the required Linux Node 20.19.0 PR/main gate. The dispatch-only support matrix is deferred multi-runtime evidence, not a required PR/main gate. It is distinct from the canonical clean-CI builder's main-push signed evidence and the ordinary path-filtered diagnostic selftest.
+Automatic CI boundary: Verify repository is the required PR/main aggregate. Pull requests require only the fast feedback lanes; main pushes also require Linux Node 20.19.0 package integration. The dispatch-only support matrix is deferred multi-runtime evidence, not a required PR/main gate. It is distinct from the canonical clean-CI builder's main-push signed evidence and the ordinary path-filtered diagnostic selftest.
 
 ## Boundaries & safety
 

package/dist/cli/cli-usage.js

@@ -2,6 +2,10 @@ function englishUsage(invocationName) {
     return [
         `Usage: ${invocationName} <command> [args...]`,
         "",
+        "Product tracks:",
+        "  Workflow Integrity                 Evidence and completion gates.",
+        "  Context Personalization (Experimental)  Local, default-off Context guidance.",
+        "",
         "Public commands:",
         "  version                      Print the packaged Persona Harness version.",
         "  init                         Install Persona Harness config and OpenCode plugin config.",
@@ -10,6 +14,7 @@ function englishUsage(invocationName) {
         "  doctor                       Diagnose local OpenCode and Persona Harness installation state.",
         "  update                       Control opt-in project-local automatic Persona Harness updates.",
         "  observe <path>               Report Java/Spring observer findings for a file or directory.",
+        "  context                      Inspect the experimental default-off Context track.",
         "  authority                    Inspect or enroll bounded external consumer authority.",
         "  feedback                     Write a project feedback template or capture a bounded owner dogfood event.",
         "  philosophy                   Inspect and resolve the local personalization profile.",
@@ -25,6 +30,7 @@ function englishUsage(invocationName) {
         `  ${invocationName} update enable --yes`,
         `  ${invocationName} update repair --yes`,
         `  ${invocationName} observe src/main/java`,
+        `  ${invocationName} context status`,
         `  ${invocationName} authority status`,
         `  ${invocationName} feedback dogfood source-read-runtime-unavailable`,
         `  ${invocationName} philosophy status`,
@@ -34,6 +40,10 @@ function koreanUsage(invocationName) {
     return [
         `사용법: ${invocationName} <명령> [인자...]`,
         "",
+        "제품 트랙:",
+        "  Workflow Integrity                 근거와 완료 게이트입니다.",
+        "  Context Personalization (Experimental)  로컬 기본 비활성 Context 안내입니다.",
+        "",
         "공개 명령:",
         "  version                      패키지된 Persona Harness 버전을 출력합니다.",
         "  init                         Persona Harness 설정과 OpenCode 플러그인 설정을 설치합니다.",
@@ -42,6 +52,7 @@ function koreanUsage(invocationName) {
         "  doctor                       로컬 OpenCode 및 Persona Harness 설치 상태를 진단합니다.",
         "  update                       프로젝트별 자동 Persona Harness 업데이트를 제어합니다.",
         "  observe <path>               파일 또는 디렉터리의 Java/Spring observer 관측 결과를 보고합니다.",
+        "  context                      실험적 기본 비활성 Context 트랙을 확인합니다.",
         "  authority                    제한된 외부 consumer authority 상태를 확인하거나 등록합니다.",
         "  feedback                     프로젝트 feedback 템플릿 또는 제한된 owner dogfood event를 기록합니다.",
         "  philosophy                   개인화 profile을 확인하고 결정을 append-only로 관리합니다.",
@@ -59,6 +70,7 @@ function koreanUsage(invocationName) {
         `  ${invocationName} update enable --yes`,
         `  ${invocationName} update repair --yes`,
         `  ${invocationName} observe src/main/java`,
+        `  ${invocationName} context status`,
         `  ${invocationName} authority status`,
         `  ${invocationName} feedback dogfood source-read-runtime-unavailable`,
         `  ${invocationName} philosophy status`,

package/dist/cli/cli-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-usage.js","sourceRoot":"","sources":["../../src/cli/cli-usage.ts"],"names":[],"mappings":"AAEA,SAAS,YAAY,CAAC,cAAsB;IAC1C,OAAO;QACL,UAAU,cAAc,sBAAsB;QAC9C,EAAE;QACF,kBAAkB;QAClB,4EAA4E;QAC5E,2FAA2F;QAC3F,iGAAiG;QACjG,+HAA+H;QAC/H,gGAAgG;QAChG,gGAAgG;QAChG,8FAA8F;QAC9F,uFAAuF;QACvF,4GAA4G;QAC5G,uFAAuF;QACvF,EAAE;QACF,WAAW;QACX,KAAK,cAAc,UAAU;QAC7B,KAAK,cAAc,YAAY;QAC/B,KAAK,cAAc,OAAO;QAC1B,KAAK,cAAc,eAAe;QAClC,KAAK,cAAc,qCAAqC;QACxD,mCAAmC,cAAc,aAAa;QAC9D,KAAK,cAAc,SAAS;QAC5B,KAAK,cAAc,sBAAsB;QACzC,KAAK,cAAc,sBAAsB;QACzC,KAAK,cAAc,wBAAwB;QAC3C,KAAK,cAAc,mBAAmB;QACtC,KAAK,cAAc,mDAAmD;QACtE,KAAK,cAAc,oBAAoB;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,SAAS,WAAW,CAAC,cAAsB;IACzC,OAAO;QACL,QAAQ,cAAc,eAAe;QACrC,EAAE;QACF,QAAQ;QACR,gEAAgE;QAChE,6EAA6E;QAC7E,6EAA6E;QAC7E,8EAA8E;QAC9E,4EAA4E;QAC5E,sEAAsE;QACtE,+EAA+E;QAC/E,2EAA2E;QAC3E,qFAAqF;QACrF,0EAA0E;QAC1E,EAAE;QACF,mCAAmC;QACnC,EAAE;QACF,KAAK;QACL,KAAK,cAAc,UAAU;QAC7B,KAAK,cAAc,YAAY;QAC/B,KAAK,cAAc,OAAO;QAC1B,KAAK,cAAc,eAAe;QAClC,KAAK,cAAc,6BAA6B;QAChD,sCAAsC,cAAc,aAAa;QACjE,KAAK,cAAc,SAAS;QAC5B,KAAK,cAAc,sBAAsB;QACzC,KAAK,cAAc,sBAAsB;QACzC,KAAK,cAAc,wBAAwB;QAC3C,KAAK,cAAc,mBAAmB;QACtC,KAAK,cAAc,mDAAmD;QACtE,KAAK,cAAc,oBAAoB;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,cAAsB,EAAE,SAAwB,IAAI;IAClF,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;AACrF,CAAC"}
+{"version":3,"file":"cli-usage.js","sourceRoot":"","sources":["../../src/cli/cli-usage.ts"],"names":[],"mappings":"AAEA,SAAS,YAAY,CAAC,cAAsB;IAC1C,OAAO;QACL,UAAU,cAAc,sBAAsB;QAC9C,EAAE;QACF,iBAAiB;QACjB,qEAAqE;QACrE,gFAAgF;QAChF,EAAE;QACF,kBAAkB;QAClB,4EAA4E;QAC5E,2FAA2F;QAC3F,iGAAiG;QACjG,+HAA+H;QAC/H,gGAAgG;QAChG,gGAAgG;QAChG,8FAA8F;QAC9F,oFAAoF;QACpF,uFAAuF;QACvF,4GAA4G;QAC5G,uFAAuF;QACvF,EAAE;QACF,WAAW;QACX,KAAK,cAAc,UAAU;QAC7B,KAAK,cAAc,YAAY;QAC/B,KAAK,cAAc,OAAO;QAC1B,KAAK,cAAc,eAAe;QAClC,KAAK,cAAc,qCAAqC;QACxD,mCAAmC,cAAc,aAAa;QAC9D,KAAK,cAAc,SAAS;QAC5B,KAAK,cAAc,sBAAsB;QACzC,KAAK,cAAc,sBAAsB;QACzC,KAAK,cAAc,wBAAwB;QAC3C,KAAK,cAAc,iBAAiB;QACpC,KAAK,cAAc,mBAAmB;QACtC,KAAK,cAAc,mDAAmD;QACtE,KAAK,cAAc,oBAAoB;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,SAAS,WAAW,CAAC,cAAsB;IACzC,OAAO;QACL,QAAQ,cAAc,eAAe;QACrC,EAAE;QACF,QAAQ;QACR,qDAAqD;QACrD,oEAAoE;QACpE,EAAE;QACF,QAAQ;QACR,gEAAgE;QAChE,6EAA6E;QAC7E,6EAA6E;QAC7E,8EAA8E;QAC9E,4EAA4E;QAC5E,sEAAsE;QACtE,+EAA+E;QAC/E,8DAA8D;QAC9D,2EAA2E;QAC3E,qFAAqF;QACrF,0EAA0E;QAC1E,EAAE;QACF,mCAAmC;QACnC,EAAE;QACF,KAAK;QACL,KAAK,cAAc,UAAU;QAC7B,KAAK,cAAc,YAAY;QAC/B,KAAK,cAAc,OAAO;QAC1B,KAAK,cAAc,eAAe;QAClC,KAAK,cAAc,6BAA6B;QAChD,sCAAsC,cAAc,aAAa;QACjE,KAAK,cAAc,SAAS;QAC5B,KAAK,cAAc,sBAAsB;QACzC,KAAK,cAAc,sBAAsB;QACzC,KAAK,cAAc,wBAAwB;QAC3C,KAAK,cAAc,iBAAiB;QACpC,KAAK,cAAc,mBAAmB;QACtC,KAAK,cAAc,mDAAmD;QACtE,KAAK,cAAc,oBAAoB;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,cAAsB,EAAE,SAAwB,IAAI;IAClF,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;AACrF,CAAC"}

package/dist/cli/context-command.d.ts

@@ -0,0 +1,12 @@
+import type { PersonalizationStoreOptions } from "./personalization-profile-store.js";
+export type ContextCommandResult = {
+    readonly status: 0 | 1;
+    readonly stdout: string;
+    readonly stderr: string;
+};
+export type ContextCommandOptions = {
+    readonly personalization?: PersonalizationStoreOptions;
+    readonly projectDir?: string;
+};
+export declare function runContextCommand(args: readonly string[], invocationName?: string, options?: ContextCommandOptions): ContextCommandResult;
+export declare function contextUsage(invocationName: string): string;

package/dist/cli/context-command.js

@@ -0,0 +1,62 @@
+import process from "node:process";
+import { runContextExplainCommand } from "./context-explain.js";
+import { runContextInitCommand } from "./context-init.js";
+import { runContextPreviewCommand } from "./context-preview.js";
+import { renderContextDoctor } from "./context-doctor.js";
+import { readContextStatus, renderContextStatus } from "./context-status.js";
+export function runContextCommand(args, invocationName = "ph", options = {}) {
+    const command = args[0];
+    if (command === undefined || command === "help" || command === "--help" || command === "-h") {
+        return success(`${contextUsage(invocationName)}\n`);
+    }
+    if (command === "init") {
+        return runContextInitCommand(args.slice(1), options.projectDir ?? process.cwd());
+    }
+    if (command === "status") {
+        if (args.length !== 1)
+            return invalidArguments(invocationName);
+        return success(renderContextStatus(readContextStatus(options.projectDir ?? process.cwd())));
+    }
+    if (command === "doctor") {
+        if (args.length !== 1)
+            return invalidArguments(invocationName);
+        return success(renderContextDoctor(readContextStatus(options.projectDir ?? process.cwd())));
+    }
+    if (command === "preview") {
+        return runContextPreviewCommand(args.slice(1), options.projectDir ?? process.cwd(), {
+            personalization: options.personalization,
+        });
+    }
+    if (command === "explain") {
+        return runContextExplainCommand(args.slice(1), options.projectDir ?? process.cwd(), {
+            personalization: options.personalization,
+        });
+    }
+    return failure(`Unknown context command.\n\n${contextUsage(invocationName)}\n`);
+}
+export function contextUsage(invocationName) {
+    return [
+        `Usage: ${invocationName} context <init|status|preview|explain|doctor>`,
+        "",
+        "Context Personalization (Experimental, default-off)",
+        "",
+        "Commands:",
+        "  init [--enable]              Preview initialization, or explicitly create Context config.",
+        "  status                       Show the bounded local Context state.",
+        "  preview <target-file> [--json] [--project <key>] [--task <key>] [--topic <topic>]",
+        "  explain <target-file> [--project <key>] [--task <key>] [--topic <topic>]",
+        "  doctor                       Diagnose only the local Context track.",
+        "",
+        "Preview and explanation are read-only; init writes only with explicit --enable.",
+    ].join("\n");
+}
+function invalidArguments(invocationName) {
+    return failure(`context-arguments-invalid\n\n${contextUsage(invocationName)}\n`);
+}
+function success(stdout) {
+    return { status: 0, stdout, stderr: "" };
+}
+function failure(stderr) {
+    return { status: 1, stdout: "", stderr };
+}
+//# sourceMappingURL=context-command.js.map

package/dist/cli/context-command.js.map

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

package/dist/cli/context-doctor.d.ts

@@ -0,0 +1,2 @@
+import type { ContextStatus } from "./context-status.js";
+export declare function renderContextDoctor(status: ContextStatus): string;

package/dist/cli/context-doctor.js

@@ -0,0 +1,19 @@
+export function renderContextDoctor(status) {
+    return [
+        "Context Doctor (Experimental)",
+        `Configuration: ${status.configuration}`,
+        `Context enabled: ${status.contextEnabled}`,
+        `Context mode: ${status.mode}`,
+        `Context budget: maxCapsules=${status.maxCapsules} maxChars=${status.maxChars}`,
+        "Context Core: available",
+        "CLI inspection: available",
+        `Team Profile: ${status.teamProfile}`,
+        "Host adapter: bundled (OpenCode 1.x)",
+        "Runtime activation: safe target observed when Context is enabled",
+        "Network access: not used",
+        "Shell access: not used",
+        `Diagnostics: ${status.diagnostics.length === 0 ? "none" : status.diagnostics.join(", ")}`,
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=context-doctor.js.map

package/dist/cli/context-doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-doctor.js","sourceRoot":"","sources":["../../src/cli/context-doctor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,OAAO;QACL,+BAA+B;QAC/B,kBAAkB,MAAM,CAAC,aAAa,EAAE;QACxC,oBAAoB,MAAM,CAAC,cAAc,EAAE;QAC3C,iBAAiB,MAAM,CAAC,IAAI,EAAE;QAC9B,+BAA+B,MAAM,CAAC,WAAW,aAAa,MAAM,CAAC,QAAQ,EAAE;QAC/E,yBAAyB;QACzB,2BAA2B;QAC3B,iBAAiB,MAAM,CAAC,WAAW,EAAE;QACrC,sCAAsC;QACtC,kEAAkE;QAClE,0BAA0B;QAC1B,wBAAwB;QACxB,gBAAgB,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC1F,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/cli/context-explain.d.ts

@@ -0,0 +1,7 @@
+import { type ContextPreviewOptions } from "./context-preview.js";
+export type ContextExplainCommandResult = {
+    readonly status: 0 | 1;
+    readonly stderr: string;
+    readonly stdout: string;
+};
+export declare function runContextExplainCommand(args: readonly string[], projectDir: string, options?: ContextPreviewOptions): ContextExplainCommandResult;

package/dist/cli/context-explain.js

@@ -0,0 +1,44 @@
+import { readContextPreview, } from "./context-preview.js";
+export function runContextExplainCommand(args, projectDir, options = {}) {
+    const result = readContextPreview(args, projectDir, options);
+    if (result.status === "blocked")
+        return failure(result.code);
+    return success(renderExplanation(result.preview));
+}
+function renderExplanation(preview) {
+    const { contextEnabled, detected, envelope, resolution } = preview;
+    const lines = [
+        "Context Explanation (Experimental)",
+        `Target: ${envelope.target.path}`,
+        `Detected language: ${detected.language}`,
+        `Detected file role: ${detected.fileRole}`,
+        `Context enabled: ${contextEnabled}`,
+        `Envelope status: ${envelope.status}`,
+    ];
+    if (resolution.status === "blocked") {
+        lines.push(`Resolution: ${resolution.reason}`);
+    }
+    else {
+        lines.push(...renderSelections(resolution));
+        lines.push(...renderShadows(resolution));
+    }
+    lines.push(`Budget: selected=${envelope.budget.usedCapsules} chars=${envelope.budget.usedChars} / capsules=${envelope.budget.maxCapsules} chars=${envelope.budget.maxChars}`, `Digest: ${envelope.digest}`);
+    return `${lines.join("\n")}\n`;
+}
+function renderSelections(preview) {
+    if (preview.selected.length === 0)
+        return ["Selected: none"];
+    return preview.selected.map((selection) => (`Selected: ${selection.id} topic=${selection.topic} layer=${selection.layer} reason=${selection.reason}`));
+}
+function renderShadows(preview) {
+    if (preview.shadowed.length === 0)
+        return ["Shadowed: none"];
+    return preview.shadowed.map((shadow) => (`Shadowed: ${shadow.id} -> ${shadow.winnerId} topic=${shadow.topic} reason=${shadow.reason}`));
+}
+function success(stdout) {
+    return { status: 0, stderr: "", stdout };
+}
+function failure(code) {
+    return { status: 1, stderr: `${code}\n`, stdout: "" };
+}
+//# sourceMappingURL=context-explain.js.map

package/dist/cli/context-explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-explain.js","sourceRoot":"","sources":["../../src/cli/context-explain.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAGnB,MAAM,sBAAsB,CAAA;AAQ7B,MAAM,UAAU,wBAAwB,CACtC,IAAuB,EACvB,UAAkB,EAClB,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC5D,OAAO,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;AACnD,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA2B;IACpD,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IAClE,MAAM,KAAK,GAAG;QACZ,oCAAoC;QACpC,WAAW,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;QACjC,sBAAsB,QAAQ,CAAC,QAAQ,EAAE;QACzC,uBAAuB,QAAQ,CAAC,QAAQ,EAAE;QAC1C,oBAAoB,cAAc,EAAE;QACpC,oBAAoB,QAAQ,CAAC,MAAM,EAAE;KACtC,CAAA;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;IAChD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAA;QAC3C,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAA;IAC1C,CAAC;IAED,KAAK,CAAC,IAAI,CACR,oBAAoB,QAAQ,CAAC,MAAM,CAAC,YAAY,UAAU,QAAQ,CAAC,MAAM,CAAC,SAAS,eAAe,QAAQ,CAAC,MAAM,CAAC,WAAW,UAAU,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,EACjK,WAAW,QAAQ,CAAC,MAAM,EAAE,CAC7B,CAAA;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAmF;IAC3G,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC5D,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CACzC,aAAa,SAAS,CAAC,EAAE,UAAU,SAAS,CAAC,KAAK,UAAU,SAAS,CAAC,KAAK,WAAW,SAAS,CAAC,MAAM,EAAE,CACzG,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAmF;IACxG,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC5D,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACtC,aAAa,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,QAAQ,UAAU,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,MAAM,EAAE,CAC7F,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,MAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAA;AAC1C,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;AACvD,CAAC"}

package/dist/cli/context-init.d.ts

@@ -0,0 +1,6 @@
+export type ContextInitCommandResult = {
+    readonly status: 0 | 1;
+    readonly stderr: string;
+    readonly stdout: string;
+};
+export declare function runContextInitCommand(args: readonly string[], projectDir: string): ContextInitCommandResult;

package/dist/cli/context-init.js

@@ -0,0 +1,176 @@
+import { closeSync, constants, fstatSync, fsyncSync, lstatSync, mkdirSync, openSync, rmdirSync, unlinkSync, writeFileSync, } from "node:fs";
+import { join, resolve } from "node:path";
+import { DEFAULT_CONTEXT_CONFIG } from "../config/context-config.js";
+import { captureNoFollowDirectory, noFollowPathIdentityFromStat, sameNoFollowPathIdentity, sameNoFollowPathLocation, } from "../io/no-follow-file.js";
+const CONFIG_FILE_NAME = "harness.jsonc";
+const PERSONA_DIRECTORY_NAME = ".persona";
+export function runContextInitCommand(args, projectDir) {
+    if (args.length === 0)
+        return preview();
+    if (args.length !== 1 || args[0] !== "--enable")
+        return failure("context-init-arguments-invalid");
+    const outcome = enableContext(projectDir);
+    if (outcome === "created")
+        return enabled();
+    if (outcome === "existing")
+        return failure("context-init-existing-config");
+    if (outcome === "unsafe")
+        return failure("context-init-path-unsafe");
+    return failure("context-init-write-unavailable");
+}
+function enableContext(projectDir) {
+    const rootPath = resolve(projectDir);
+    const root = captureNoFollowDirectory(rootPath);
+    if (root.kind !== "ready")
+        return "unsafe";
+    const persona = reservePersonaDirectory(rootPath, root.value);
+    if (persona === undefined)
+        return "unsafe";
+    const configPath = join(persona.path, CONFIG_FILE_NAME);
+    const before = inspectConfigFile(configPath);
+    if (before === "existing")
+        return "existing";
+    if (before === "unsafe") {
+        removeEmptyCreatedPersona(persona);
+        return "unsafe";
+    }
+    let descriptor;
+    let createdIdentity;
+    let completed = false;
+    try {
+        if (!sameDirectoryLocation(rootPath, root.value) || !sameDirectoryLocation(persona.path, persona.identity)) {
+            return "unsafe";
+        }
+        descriptor = openSync(configPath, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
+        const opened = fstatSync(descriptor, { bigint: true });
+        if (!opened.isFile())
+            return "unsafe";
+        createdIdentity = noFollowPathIdentityFromStat(opened);
+        writeFileSync(descriptor, contextConfigText());
+        fsyncSync(descriptor);
+        const afterWrite = noFollowPathIdentityFromStat(fstatSync(descriptor, { bigint: true }));
+        const pathAfterWrite = lstatSync(configPath, { bigint: true });
+        if (!pathAfterWrite.isFile()
+            || pathAfterWrite.isSymbolicLink()
+            || !sameNoFollowPathIdentity(afterWrite, noFollowPathIdentityFromStat(pathAfterWrite))
+            || !sameDirectoryLocation(rootPath, root.value)
+            || !sameDirectoryLocation(persona.path, persona.identity)) {
+            return "unsafe";
+        }
+        createdIdentity = afterWrite;
+        completed = true;
+        return "created";
+    }
+    catch (error) {
+        const after = inspectConfigFile(configPath);
+        if (after === "existing" && createdIdentity === undefined)
+            return "existing";
+        if (after === "unsafe")
+            return "unsafe";
+        return isAlreadyPresent(error) ? "existing" : "unavailable";
+    }
+    finally {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+        if (!completed && createdIdentity !== undefined) {
+            removeOwnedConfig(configPath, createdIdentity);
+        }
+        if (!completed) {
+            removeEmptyCreatedPersona(persona);
+        }
+    }
+}
+function reservePersonaDirectory(rootPath, rootIdentity) {
+    const personaPath = join(rootPath, PERSONA_DIRECTORY_NAME);
+    const existing = captureNoFollowDirectory(personaPath);
+    if (existing.kind === "ready")
+        return { created: false, identity: existing.value, path: personaPath };
+    if (existing.kind === "blocked")
+        return undefined;
+    let createdHere = false;
+    try {
+        mkdirSync(personaPath, { mode: 0o700 });
+        createdHere = true;
+    }
+    catch (error) {
+        if (!isAlreadyPresent(error))
+            return undefined;
+    }
+    const created = captureNoFollowDirectory(personaPath);
+    if (created.kind !== "ready" || !sameDirectoryLocation(rootPath, rootIdentity))
+        return undefined;
+    return { created: createdHere, identity: created.value, path: personaPath };
+}
+function inspectConfigFile(path) {
+    try {
+        const stat = lstatSync(path, { bigint: true });
+        return stat.isFile() && !stat.isSymbolicLink() ? "existing" : "unsafe";
+    }
+    catch (error) {
+        return isMissing(error) ? "absent" : "unsafe";
+    }
+}
+function sameDirectoryLocation(path, expected) {
+    const current = captureNoFollowDirectory(path);
+    return current.kind === "ready" && sameNoFollowPathLocation(current.value, expected);
+}
+function contextConfigText() {
+    return `${JSON.stringify({
+        context: {
+            enabled: true,
+            maxCapsules: DEFAULT_CONTEXT_CONFIG.maxCapsules,
+            maxChars: DEFAULT_CONTEXT_CONFIG.maxChars,
+            mode: DEFAULT_CONTEXT_CONFIG.mode,
+        },
+    }, null, 2)}\n`;
+}
+function preview() {
+    return success([
+        "Context Personalization (Experimental)",
+        "Initialization: preview-only",
+        "Context enabled: false",
+        "Context Core: available",
+        "No files were written.",
+        "",
+    ].join("\n"));
+}
+function enabled() {
+    return success([
+        "Context Personalization (Experimental)",
+        "Initialization: enabled",
+        "Configuration: .persona/harness.jsonc",
+        "Context enabled: true",
+        "No host adapter was activated.",
+        "",
+    ].join("\n"));
+}
+function success(stdout) {
+    return { status: 0, stderr: "", stdout };
+}
+function failure(code) {
+    return { status: 1, stderr: `${code}\n`, stdout: "" };
+}
+function removeOwnedConfig(path, expected) {
+    try {
+        const current = lstatSync(path, { bigint: true });
+        if (current.isFile() && !current.isSymbolicLink() && sameNoFollowPathLocation(expected, noFollowPathIdentityFromStat(current))) {
+            unlinkSync(path);
+        }
+    }
+    catch { }
+}
+function removeEmptyCreatedPersona(persona) {
+    if (!persona.created || !sameDirectoryLocation(persona.path, persona.identity))
+        return;
+    try {
+        rmdirSync(persona.path);
+    }
+    catch { }
+}
+function isAlreadyPresent(error) {
+    return error !== null && typeof error === "object" && "code" in error && error.code === "EEXIST";
+}
+function isMissing(error) {
+    return error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT";
+}
+//# sourceMappingURL=context-init.js.map

package/dist/cli/context-init.js.map

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

package/dist/cli/context-preview-request.d.ts

@@ -0,0 +1,16 @@
+export type ContextPreviewFormat = "json" | "text";
+export type ContextPreviewRequest = {
+    readonly format: ContextPreviewFormat;
+    readonly projectKey?: string;
+    readonly targetPath: string;
+    readonly taskKey?: string;
+    readonly topics: readonly string[];
+};
+export type ContextPreviewRequestResult = {
+    readonly status: "ready";
+    readonly request: ContextPreviewRequest;
+} | {
+    readonly status: "blocked";
+    readonly code: "context-preview-arguments-invalid" | "context-target-invalid" | "context-target-required";
+};
+export declare function parseContextPreviewRequest(args: readonly string[]): ContextPreviewRequestResult;

package/dist/cli/context-preview-request.js

@@ -0,0 +1,71 @@
+export function parseContextPreviewRequest(args) {
+    if (args.length === 0)
+        return { code: "context-target-required", status: "blocked" };
+    const targetPath = parseTargetPath(args[0]);
+    if (targetPath === undefined)
+        return { code: "context-target-invalid", status: "blocked" };
+    let format = "text";
+    let projectKey;
+    let taskKey;
+    const topics = new Set();
+    for (let index = 1; index < args.length; index += 1) {
+        const option = args[index];
+        if (option === "--json") {
+            if (format === "json")
+                return invalidArguments();
+            format = "json";
+            continue;
+        }
+        if (option === "--project") {
+            const value = optionValue(args, index);
+            if (value === undefined || projectKey !== undefined)
+                return invalidArguments();
+            projectKey = value;
+            index += 1;
+            continue;
+        }
+        if (option === "--task") {
+            const value = optionValue(args, index);
+            if (value === undefined || taskKey !== undefined)
+                return invalidArguments();
+            taskKey = value;
+            index += 1;
+            continue;
+        }
+        if (option === "--topic") {
+            const value = optionValue(args, index);
+            if (value === undefined)
+                return invalidArguments();
+            topics.add(value);
+            index += 1;
+            continue;
+        }
+        return invalidArguments();
+    }
+    return {
+        request: { format, projectKey, targetPath, taskKey, topics: [...topics].sort() },
+        status: "ready",
+    };
+}
+function invalidArguments() {
+    return { code: "context-preview-arguments-invalid", status: "blocked" };
+}
+function optionValue(args, optionIndex) {
+    const value = args[optionIndex + 1];
+    return value !== undefined && !value.startsWith("--") && isSafeIdentifier(value) ? value : undefined;
+}
+function parseTargetPath(value) {
+    if (value === undefined || value.length === 0 || value.length > 240 || /[\u0000-\u001f\u007f]/u.test(value))
+        return undefined;
+    const normalized = value.replaceAll("\\\\", "/");
+    if (normalized.startsWith("/") || /^(?:[A-Za-z]:\/|https?:\/\/)/u.test(normalized))
+        return undefined;
+    const segments = normalized.split("/");
+    if (segments.some((segment) => segment.length === 0 || segment === "." || segment === ".."))
+        return undefined;
+    return normalized;
+}
+function isSafeIdentifier(value) {
+    return /^[A-Za-z0-9][A-Za-z0-9._-]{0,119}$/u.test(value);
+}
+//# sourceMappingURL=context-preview-request.js.map

package/dist/cli/context-preview-request.js.map

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