persona-harness 0.13.0 → 1.1.0

package/CHANGELOG.md

@@ -8,6 +8,33 @@ preparation alone does not establish stable support or channel state.
 
 ## Unreleased
 
+## [1.1.0] - 2026-09-07
+
+- Bundle consent/setup, targeted Context hooks and Java reference/checker assets
+  in the portable Codex and Claude plugins. Reuse approved decisions and ask
+  only about unresolved choices that change implementation.
+- Add explicit checkout-local project connections and session-local task
+  inspection/resume/Preview/end commands. Preserve profile V1, explicit opt-out,
+  unrelated user files and existing Workflow Integrity/Finish authority.
+- Share full PH-block rendering limits between Preview and delivery; preserve
+  multi-file snapshots and fail closed on invalid or incomplete selection.
+- Verification evidence includes workspace integration tests, local-tarball
+  npm-installed contracts and bounded isolated Codex Luna Max observations.
+  It is not registry smoke, universal model compliance or generated-app product
+  quality certification. Claude live behavior and token savings are not claimed.
+
+## [1.0.0] - 2026-09-05
+
+- Deliver common authorization-aware skill guidance across portable host
+  adapters and managed AGENTS instructions, with Astra migration documentation.
+- Preserve task continuity through status questions and corrections; explain
+  confusion before advancing and honor stop without a new interview question.
+- Reuse existing approval for implementation and review, size verification to
+  the changed behavior, and retain workflow completion evidence requirements.
+- Block automatic OpenCode pin changes across major versions before writes;
+  retain explicit version-selected upgrades and user customization.
+- Keep Context opt-in and legacy runtime-injection defaults unchanged.
+
 ## [0.13.0] - 2026-09-03
 
 - Add a portable Socratic product-discovery core and the explicit `ph interview`

package/README.md

@@ -6,7 +6,7 @@
 
 # Persona Harness
 
-**Evidence-first workflow gates and portable skill adapters for AI coding agents building Java/Spring backends.**
+**Project philosophy, conventions, and evidence-first workflows for AI coding agents, with portable skills and a Java/Spring workflow rail.**
 
 [![npm version](https://img.shields.io/npm/v/persona-harness?color=369eff&labelColor=black&style=flat-square)](https://www.npmjs.com/package/persona-harness)
 [![npm downloads](https://img.shields.io/npm/dt/persona-harness?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/persona-harness)
@@ -17,6 +17,8 @@
 
 **[Start Here](docs/START-HERE.md) · [Quick Demo](docs/QUICK-DEMO.md) · [Measured Claims](docs/MEASURED-CLAIMS.md)**
 
+[Astra migration, prompts, and AGENTS.md (한국어)](docs/current/astra-migration-guide.ko.md)
+
 </div>
 
 <!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
@@ -65,7 +67,7 @@ production readiness, token savings, or broad security guarantees.
 **Start with:** [Quick Demo](docs/QUICK-DEMO.md) · [Measured Claims](docs/MEASURED-CLAIMS.md) · [Install guide](docs/START-HERE.md)
 
 > [!IMPORTANT]
-> **Alpha, gate-first, measured.** Live registry channels, tags, GitHub releases,
+> **Versioned, evidence-first.** Live registry channels, tags, GitHub releases,
 > and audit lifecycle facts are maintained by governed workflows and release
 > records; source release notes are inputs, not standalone proof. Runtime
 > injection remains **default-off / opt-in**. See
@@ -103,9 +105,10 @@ 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.
+  targeted convention guidance. Enabled adapters offer a bounded Context block
+  after safe observed file targets. Version 1.1.0 adds
+  Codex and Claude plugin hooks alongside OpenCode; this does not establish
+  live model receipt or grant completion authority.
 
 ### Context Boundary
 
@@ -115,13 +118,15 @@ Persona Harness exposes two deliberately separate tracks:
   verification authority.
 - **Isolation:** Context-only paths do not execute project commands or contact
   GitHub/network.
-- **No inferred skill route:** a Context-only or partial `.persona` directory
+- **No inferred skill route:** for the existing OpenCode route, a Context-only or partial `.persona` directory
   without the regular manifest created by `ph init` does not enable automatic
   shared-skill routing or an interview. Resolve the project state explicitly
   before enabling those routes.
 - **Host:** `ph init` installs static skill adapters for Codex, Claude Code,
-  OpenCode, and Antigravity. Context delivery is currently implemented only by
-  the optional OpenCode adapter and remains a separate, unobserved boundary.
+  OpenCode, and Antigravity. The packaged Codex/Claude hooks add
+  bounded session guidance and targeted Context transport after host trust.
+  Actual delivery and behavior remain separate observations; see the
+  [portable host boundary](docs/current/portable-host-adapters.md).
 - **Evidence:** Context usefulness remains `INCONCLUSIVE` until independent
   external evidence exists.
 - **Product focus:** the productized workflow focus is Java/Spring. The
@@ -206,12 +211,14 @@ the previous tracked configuration through your normal version-control flow.
 These lifecycle actions do not enable `features.runtimeInjection`, and they do
 not create workflow, evidence, or authority state or use network or GitHub.
 
-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
+With Context enabled, the OpenCode adapter collects safe observed
+project-relative targets from supported file tools, including multi-file patches.
+It resolves one current profile snapshot for the entire pending batch,
+rejects invalid/unsafe/budget-exceeding input without a rule payload, 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
+same session. It suppresses a duplicate only when the exact synthetic block is
+visible in the current model input; it does not assume retained delivery from
+an earlier transform. 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.

package/dist/cli/agents-contract.js

@@ -1,3 +1,4 @@
+import { PERSONA_EXECUTION_GUIDANCE } from "../runtime/skill-execution-guidance.js";
 export const AGENTS_START_MARKER = "<!-- persona-harness:agents:start schema=persona-harness.agents.v1 -->";
 export const AGENTS_END_MARKER = "<!-- persona-harness:agents:end -->";
 export const LEGACY_AGENTS_TITLE = "# Persona Harness Agent Instructions";
@@ -9,6 +10,9 @@ export function backendAgentInstructions() {
         "",
         "This project is initialized with Persona Harness for Java/Spring backend work.",
         "",
+        "Working agreements:",
+        PERSONA_EXECUTION_GUIDANCE,
+        "",
         "Project-local philosophy:",
         "- Read `.persona/project-profile.jsonc` directly. Do not rely on Glob results for hidden `.persona` paths.",
         "- Use the project profile as the source of truth for language, framework, build tool, storage, persistence, migration, package style, and architecture style.",

package/dist/cli/agents-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-contract.js","sourceRoot":"","sources":["../../src/cli/agents-contract.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAC9B,wEAAwE,CAAA;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,qCAAqC,CAAA;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,sCAAsC,CAAA;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,2BAA2B,CAAA;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,kCAAkC,CAAA;AAEvE,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,mBAAmB;QACnB,EAAE;QACF,gFAAgF;QAChF,EAAE;QACF,2BAA2B;QAC3B,4GAA4G;QAC5G,+JAA+J;QAC/J,mHAAmH;QACnH,+NAA+N;QAC/N,2GAA2G;QAC3G,EAAE;QACF,oBAAoB;QACpB,0EAA0E;QAC1E,iKAAiK;QACjK,oIAAoI;QACpI,4KAA4K;QAC5K,EAAE;QACF,yDAAyD;QACzD,iFAAiF;QACjF,mFAAmF;QACnF,EAAE;QACF,8CAA8C;QAC9C,gBAAgB;QAChB,0BAA0B;QAC1B,kBAAkB;QAClB,qBAAqB;QACrB,EAAE;QACF,2CAA2C;QAC3C,sDAAsD;QACtD,8CAA8C;QAC9C,sEAAsE;QACtE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,mBAAmB;QACnB,wBAAwB,EAAE,CAAC,OAAO,EAAE;QACpC,iBAAiB;QACjB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,QAAgB;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC5C,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QAC9B,OAAO;YACL,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;YACxB,GAAG,+BAA+B,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;YAC1D,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;SACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,+BAA+B,EAAE,CAAA;AAC1C,CAAC"}
+{"version":3,"file":"agents-contract.js","sourceRoot":"","sources":["../../src/cli/agents-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAA;AAEnF,MAAM,CAAC,MAAM,mBAAmB,GAC9B,wEAAwE,CAAA;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,qCAAqC,CAAA;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,sCAAsC,CAAA;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,2BAA2B,CAAA;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,kCAAkC,CAAA;AAEvE,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,mBAAmB;QACnB,EAAE;QACF,gFAAgF;QAChF,EAAE;QACF,qBAAqB;QACrB,0BAA0B;QAC1B,EAAE;QACF,2BAA2B;QAC3B,4GAA4G;QAC5G,+JAA+J;QAC/J,mHAAmH;QACnH,+NAA+N;QAC/N,2GAA2G;QAC3G,EAAE;QACF,oBAAoB;QACpB,0EAA0E;QAC1E,iKAAiK;QACjK,oIAAoI;QACpI,4KAA4K;QAC5K,EAAE;QACF,yDAAyD;QACzD,iFAAiF;QACjF,mFAAmF;QACnF,EAAE;QACF,8CAA8C;QAC9C,gBAAgB;QAChB,0BAA0B;QAC1B,kBAAkB;QAClB,qBAAqB;QACrB,EAAE;QACF,2CAA2C;QAC3C,sDAAsD;QACtD,8CAA8C;QAC9C,sEAAsE;QACtE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,mBAAmB;QACnB,wBAAwB,EAAE,CAAC,OAAO,EAAE;QACpC,iBAAiB;QACjB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,QAAgB;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC5C,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QAC9B,OAAO;YACL,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;YACxB,GAAG,+BAA+B,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;YAC1D,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;SACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,+BAA+B,EAAE,CAAA;AAC1C,CAAC"}

package/dist/cli/context-checkout-binding.d.ts

@@ -0,0 +1,31 @@
+import { type PersonalizationStoreOptions } from "./personalization-store-io.js";
+type ScopeBindingOptions = PersonalizationStoreOptions & {
+    readonly taskSession?: string;
+};
+export type ContextScopeBinding = {
+    readonly status: "unbound";
+} | {
+    readonly status: "bound";
+    readonly scopeKey: string;
+};
+export type CheckoutProjectBinding = {
+    readonly status: "unbound";
+} | {
+    readonly status: "bound";
+    readonly projectKey: string;
+};
+export declare class ContextScopeError extends Error {
+    readonly code: "context-scope-unavailable" | "context-scope-invalid" | "context-scope-existing-binding" | "context-scope-key-mismatch";
+    constructor(code: "context-scope-unavailable" | "context-scope-invalid" | "context-scope-existing-binding" | "context-scope-key-mismatch");
+}
+export declare function readCheckoutProjectBinding(projectDir: string, options?: PersonalizationStoreOptions): CheckoutProjectBinding;
+export declare function changeCheckoutProjectBinding(projectDir: string, change: {
+    readonly action: "bind" | "unbind";
+    readonly projectKey: string;
+}, options?: PersonalizationStoreOptions): CheckoutProjectBinding;
+export declare function readContextScopeBinding(projectDir: string, options: ScopeBindingOptions): ContextScopeBinding;
+export declare function changeContextScopeBinding(projectDir: string, change: {
+    readonly action: "bind" | "unbind";
+    readonly scopeKey: string;
+}, options: ScopeBindingOptions): ContextScopeBinding;
+export {};

package/dist/cli/context-checkout-binding.js

@@ -0,0 +1,170 @@
+import { randomUUID } from "node:crypto";
+import { closeSync, constants, fstatSync, fsyncSync, linkSync, lstatSync, openSync, realpathSync, unlinkSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { isRecord } from "../config/jsonc.js";
+import { canonicalContextDigest } from "../context-core/context-digest.js";
+import { withNoFollowDirectoryChain } from "../io/no-follow-directory-chain.js";
+import { captureNoFollowDirectory, noFollowPathIdentityFromStat, readNoFollowProjectFile, sameNoFollowPathLocation } from "../io/no-follow-file.js";
+import { personalizationStorePath } from "./personalization-store-io.js";
+const MAX_BYTES = 4_096;
+export class ContextScopeError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = "ContextScopeError";
+    }
+}
+export function readCheckoutProjectBinding(projectDir, options = {}) {
+    const result = readContextScopeBinding(projectDir, options);
+    return result.status === "bound" ? { status: "bound", projectKey: result.scopeKey } : result;
+}
+export function changeCheckoutProjectBinding(projectDir, change, options = {}) {
+    const result = changeContextScopeBinding(projectDir, { action: change.action, scopeKey: change.projectKey }, options);
+    return result.status === "bound" ? { status: "bound", projectKey: result.scopeKey } : result;
+}
+export function readContextScopeBinding(projectDir, options) {
+    const location = bindingLocation(projectDir, options);
+    const file = readNoFollowProjectFile(location.root, location.relativePath, MAX_BYTES);
+    switch (file.kind) {
+        case "absent": return { status: "unbound" };
+        case "blocked": throw new ContextScopeError("context-scope-unavailable");
+        case "ready": return parseBinding(file.value.bytes, location);
+        default: return assertNever(file);
+    }
+}
+export function changeContextScopeBinding(projectDir, change, options) {
+    const checkoutPath = resolve(projectDir);
+    const location = bindingLocation(checkoutPath, options);
+    const root = captureNoFollowDirectory(location.root);
+    if (root.kind !== "ready")
+        throw new ContextScopeError("context-scope-unavailable");
+    const existing = readContextScopeBinding(checkoutPath, options);
+    if (existing.status === "bound" && existing.scopeKey !== change.scopeKey) {
+        throw new ContextScopeError(change.action === "bind" ? "context-scope-existing-binding" : "context-scope-key-mismatch");
+    }
+    if (existing.status === "unbound" && change.action === "unbind")
+        return existing;
+    if (existing.status === "bound" && change.action === "bind")
+        return existing;
+    const result = withNoFollowDirectoryChain(join(location.root, location.directory), 0o700, () => {
+        const parent = captureNoFollowDirectory("..");
+        if (parent.kind !== "ready" || !sameNoFollowPathLocation(root.value, parent.value)
+            || bindingLocation(checkoutPath, options).bindingDigest !== location.bindingDigest) {
+            throw new ContextScopeError("context-scope-unavailable");
+        }
+        const leaf = basename(location.relativePath);
+        const lock = `${leaf}.lock`;
+        const lockDescriptor = openSync(lock, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
+        try {
+            const latest = readContextScopeBinding(checkoutPath, options);
+            if (latest.status === "bound" && latest.scopeKey !== change.scopeKey) {
+                throw new ContextScopeError(change.action === "bind" ? "context-scope-existing-binding" : "context-scope-key-mismatch");
+            }
+            if (latest.status === "unbound" && change.action === "unbind")
+                return latest;
+            if (latest.status === "bound" && change.action === "bind")
+                return latest;
+            switch (change.action) {
+                case "bind": {
+                    const temporary = `.binding-${randomUUID()}.tmp`;
+                    const descriptor = openSync(temporary, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
+                    let temporaryPresent = true;
+                    try {
+                        writeFileSync(descriptor, `${JSON.stringify({ schemaVersion: location.schema, [location.digestField]: location.bindingDigest, [location.keyField]: change.scopeKey })}\n`);
+                        fsyncSync(descriptor);
+                        // Publish complete bytes without replacing any existing binding.
+                        linkSync(temporary, leaf);
+                        unlinkSync(temporary);
+                        temporaryPresent = false;
+                        const opened = fstatSync(descriptor, { bigint: true });
+                        const current = lstatSync(leaf, { bigint: true });
+                        if (!opened.isFile() || opened.nlink !== 1n || current.isSymbolicLink()
+                            || !sameNoFollowPathLocation(noFollowPathIdentityFromStat(opened), noFollowPathIdentityFromStat(current))) {
+                            throw new ContextScopeError("context-scope-unavailable");
+                        }
+                    }
+                    finally {
+                        closeSync(descriptor);
+                        if (temporaryPresent)
+                            unlinkSync(temporary);
+                    }
+                    return { status: "bound", scopeKey: change.scopeKey };
+                }
+                case "unbind": {
+                    const file = readNoFollowProjectFile(location.root, location.relativePath, MAX_BYTES);
+                    if (file.kind !== "ready" || parseBinding(file.value.bytes, location).scopeKey !== change.scopeKey) {
+                        throw new ContextScopeError("context-scope-unavailable");
+                    }
+                    unlinkSync(leaf);
+                    return { status: "unbound" };
+                }
+                default: return assertNever(change.action);
+            }
+        }
+        finally {
+            closeSync(lockDescriptor);
+            unlinkSync(lock);
+        }
+    });
+    if (result === undefined)
+        throw new ContextScopeError("context-scope-unavailable");
+    return result;
+}
+function bindingLocation(projectDir, options) {
+    if (options.taskSession !== undefined && !/^[a-f0-9]{64}$/u.test(options.taskSession))
+        throw new ContextScopeError("context-scope-invalid");
+    const projectPath = resolve(projectDir);
+    const captured = captureNoFollowDirectory(projectPath);
+    if (captured.kind !== "ready")
+        throw new ContextScopeError("context-scope-unavailable");
+    let canonicalPath;
+    let birthtime;
+    try {
+        canonicalPath = realpathSync.native(projectPath);
+        const stat = lstatSync(canonicalPath, { bigint: true });
+        if (!stat.isDirectory() || !sameNoFollowPathLocation(captured.value, noFollowPathIdentityFromStat(stat))) {
+            throw new ContextScopeError("context-scope-unavailable");
+        }
+        birthtime = stat.birthtimeNs.toString();
+    }
+    catch (error) {
+        if (error instanceof ContextScopeError)
+            throw error;
+        throw new ContextScopeError("context-scope-unavailable");
+    }
+    const checkoutDigest = canonicalContextDigest({ path: canonicalPath, dev: captured.value.dev, ino: captured.value.ino, birthtime });
+    const root = dirname(personalizationStorePath(options));
+    const task = options.taskSession !== undefined;
+    const bindingDigest = task ? canonicalContextDigest({ checkoutDigest, sessionHandle: options.taskSession }) : checkoutDigest;
+    const directory = task ? "task-bindings" : "project-bindings";
+    return {
+        root, bindingDigest, directory, relativePath: `${directory}/${bindingDigest}.json`,
+        schema: task ? "persona-context-task-binding.1" : "persona-context-checkout-binding.1",
+        digestField: task ? "bindingDigest" : "checkoutDigest",
+        keyField: task ? "taskKey" : "projectKey",
+    };
+}
+function parseBinding(bytes, location) {
+    let value;
+    try {
+        value = JSON.parse(bytes.toString("utf8"));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            throw new ContextScopeError("context-scope-invalid");
+        throw error;
+    }
+    if (!isRecord(value) || Object.keys(value).length !== 3
+        || value.schemaVersion !== location.schema || value[location.digestField] !== location.bindingDigest) {
+        throw new ContextScopeError("context-scope-invalid");
+    }
+    const scopeKey = value[location.keyField];
+    if (typeof scopeKey !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._-]{0,119}$/u.test(scopeKey))
+        throw new ContextScopeError("context-scope-invalid");
+    return { status: "bound", scopeKey };
+}
+function assertNever(value) {
+    throw new ContextScopeError("context-scope-invalid");
+}
+//# sourceMappingURL=context-checkout-binding.js.map

package/dist/cli/context-checkout-binding.js.map

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

package/dist/cli/context-command.js

@@ -2,6 +2,8 @@ import process from "node:process";
 import { runContextExplainCommand } from "./context-explain.js";
 import { runContextInitCommand } from "./context-init.js";
 import { runContextPreviewCommand } from "./context-preview.js";
+import { runContextScopeCommand } from "./context-scope-command.js";
+import { runContextTaskCommand } from "./context-task-command.js";
 import { renderContextDoctor } from "./context-doctor.js";
 import { readContextStatus, renderContextStatus } from "./context-status.js";
 export function runContextCommand(args, invocationName = "ph", options = {}) {
@@ -12,6 +14,12 @@ export function runContextCommand(args, invocationName = "ph", options = {}) {
     if (command === "init") {
         return runContextInitCommand(args.slice(1), options.projectDir ?? process.cwd());
     }
+    if (command === "scope") {
+        return runContextScopeCommand(args.slice(1), options.projectDir ?? process.cwd(), options.personalization);
+    }
+    if (command === "task") {
+        return runContextTaskCommand(args.slice(1), options.projectDir ?? process.cwd(), options.personalization);
+    }
     if (command === "status") {
         if (args.length !== 1)
             return invalidArguments(invocationName);
@@ -36,7 +44,7 @@ export function runContextCommand(args, invocationName = "ph", options = {}) {
 }
 export function contextUsage(invocationName) {
     return [
-        `Usage: ${invocationName} context <init|status|preview|explain|doctor>`,
+        `Usage: ${invocationName} context <init|status|preview|explain|doctor|scope|task>`,
         "",
         "Context Personalization (Experimental, default-off)",
         "",
@@ -46,8 +54,11 @@ export function contextUsage(invocationName) {
         "  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.",
+        "  scope [bind|unbind --project <key>]  Inspect or explicitly change this checkout's project binding.",
+        "  task --session <handle> [resume|end --task <key>]  Inspect or explicitly change a session's task connection.",
+        "  task --session <handle> preview <target-file> [--json] [--topic <topic>]",
         "",
-        "Preview and explanation are read-only; init writes only with explicit --enable.",
+        "Preview, explanation and scope/task inspection are read-only. Scope bind/unbind and task resume/end are explicit local writes; init requires --enable.",
     ].join("\n");
 }
 function invalidArguments(invocationName) {

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

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

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

@@ -0,0 +1,15 @@
+import type { ContextEnvelope, ContextWarning } from "../context-core/context-envelope.js";
+import type { ContextRelevance, ContextRule, ContextScope } from "../context-core/rule-types.js";
+import { type PersonalizationStoreOptions } from "./personalization-store-io.js";
+export type ContextPersonalization = {
+    readonly personalRules: readonly ContextRule[];
+    readonly projectContracts: readonly ContextRule[];
+    readonly taskDecisions: readonly ContextRule[];
+    readonly warnings: readonly ContextWarning[];
+};
+export declare function readContextPersonalization(options?: PersonalizationStoreOptions, scopeKeys?: Pick<ContextRelevance, "projectKey" | "taskKey">): ContextPersonalization;
+export declare function withPersonalizationWarnings(envelope: ContextEnvelope, profile: ContextPersonalization, scopeKeys?: Pick<ContextRelevance, "projectKey" | "taskKey">): ContextEnvelope;
+export declare function contextScope(scope: {
+    readonly key: string;
+    readonly kind: "personal" | "project" | "task";
+} | null | undefined): ContextScope | undefined;

package/dist/cli/context-personalization.js

@@ -0,0 +1,51 @@
+import { canonicalContextDigest } from "../context-core/context-digest.js";
+import { renderContextEnvelope } from "../context-core/context-renderer.js";
+import { readPersonalizationStoreSnapshot } from "./personalization-store-io.js";
+export function readContextPersonalization(options, scopeKeys = {}) {
+    const snapshot = readPersonalizationStoreSnapshot(options);
+    const rules = snapshot.document.profile.activeRules;
+    const warnings = snapshot.status === "missing"
+        ? [{ code: "personal-profile-missing", message: "No personal profile is initialized; defaults are not approved personal philosophy." }]
+        : rules.length === 0
+            ? [{ code: "personal-profile-empty", message: "The personal profile contains no active approved rules." }]
+            : [];
+    if (scopeKeys.projectKey === undefined && rules.some((rule) => rule.scope.kind === "project")) {
+        warnings.push({ code: "project-scope-unbound", message: "Project-scoped rules exist, but no project identity was supplied; those rules were not applied." });
+    }
+    if (scopeKeys.taskKey === undefined && rules.some((rule) => rule.scope.kind === "task")) {
+        warnings.push({ code: "task-scope-unbound", message: "Task-scoped rules exist, but no task identity was supplied; those rules were not applied." });
+    }
+    return {
+        personalRules: rules.filter((rule) => rule.scope.kind === "personal").map(toContextRule),
+        projectContracts: rules.filter((rule) => rule.scope.kind === "project").map(toContextRule),
+        taskDecisions: rules.filter((rule) => rule.scope.kind === "task").map(toContextRule),
+        warnings,
+    };
+}
+export function withPersonalizationWarnings(envelope, profile, scopeKeys = {}) {
+    const warnings = profile.warnings.filter((warning) => !(warning.code === "project-scope-unbound" && scopeKeys.projectKey !== undefined)
+        && !(warning.code === "task-scope-unbound" && scopeKeys.taskKey !== undefined));
+    if (warnings.length === 0)
+        return envelope;
+    const { digest: _digest, ...body } = envelope;
+    const payload = { ...body, warnings: [...body.warnings, ...warnings] };
+    if (payload.status === "blocked")
+        return { ...payload, digest: canonicalContextDigest(payload) };
+    const usedChars = renderContextEnvelope({ ...payload, digest: "" }).length;
+    const budget = { ...payload.budget, usedChars };
+    if (usedChars > budget.maxChars) {
+        const blocked = { ...payload, budget, status: "blocked", blockReason: "budget-exceeded", selected: [] };
+        return { ...blocked, digest: canonicalContextDigest(blocked) };
+    }
+    const resolved = { ...payload, budget };
+    return { ...resolved, digest: canonicalContextDigest(resolved) };
+}
+function toContextRule(rule) {
+    return { id: rule.ruleId, rule: rule.rule, scope: contextScope(rule.scope), status: "active", topic: rule.topic };
+}
+export function contextScope(scope) {
+    if (scope === undefined || scope === null || scope.kind === "personal")
+        return undefined;
+    return { key: scope.key, kind: scope.kind };
+}
+//# sourceMappingURL=context-personalization.js.map

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

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

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

@@ -5,7 +5,7 @@ export type ContextPreviewCommandResult = {
     readonly stderr: string;
     readonly stdout: string;
 };
-export type ContextPreviewFailureCode = "context-config-invalid" | "context-config-unavailable" | "context-personal-profile-unavailable" | "context-target-invalid" | "context-target-required" | "context-team-profile-invalid" | "context-topic-unavailable" | "context-preview-arguments-invalid";
+export type ContextPreviewFailureCode = "context-config-invalid" | "context-config-unavailable" | "context-personal-profile-unavailable" | "context-target-invalid" | "context-target-required" | "context-team-profile-invalid" | "context-topic-unavailable" | "context-preview-arguments-invalid" | "context-scope-unavailable";
 export type ContextTargetDetection = {
     readonly fileRole: string;
     readonly language: string;
@@ -28,3 +28,4 @@ export type ContextPreviewReadResult = {
 };
 export declare function runContextPreviewCommand(args: readonly string[], projectDir: string, options?: ContextPreviewOptions): ContextPreviewCommandResult;
 export declare function readContextPreview(args: readonly string[], projectDir: string, options?: ContextPreviewOptions): ContextPreviewReadResult;
+export declare function createContextPreviewReader(projectDir: string, options?: ContextPreviewOptions): (args: readonly string[]) => ContextPreviewReadResult;