@principles/host-runtime 0.7.12 → 0.7.13

package/dist/index.d.ts

@@ -66,6 +66,8 @@ export declare function createProductionHostRuntime(options?: Partial<Pick<HostR
     painDatabaseFactory?: PainDatabaseFactory;
     /** PRI-640: host attribution supplied by the constructing host adapter (OpenClaw / Codex). */
     hostKind?: GovernanceHostKind;
+    /** Host project cwd, distinct from the workspace owning shared PD state. */
+    projectDir?: string;
     /** PRI-634-F: host-declared tool semantics supplied by the constructing host adapter. */
     toolSemantics?: ToolSemanticRegistry;
     /**

package/dist/index.js

@@ -163,6 +163,7 @@ export function createHostRuntime(options) {
 }
 export function createProductionHostRuntime(options = {}) {
     const productionGate = createProductionRuleHostGate({
+        ...(options.projectDir ? { projectDir: options.projectDir } : {}),
         ...(options.ruleContextProvider ? { ruleContextProvider: options.ruleContextProvider } : {}),
         ...(options.ruleInputEnrichmentProvider ? { ruleInputEnrichmentProvider: options.ruleInputEnrichmentProvider } : {}),
         ...(options.ruleImplementationRuntime ? { implementationRuntime: options.ruleImplementationRuntime } : {}),

package/dist/production-rulehost-gate.d.ts

@@ -16,6 +16,7 @@ export interface RuleInputEnrichment {
 }
 export type RuleInputEnrichmentProvider = (request: ProductionRuleContextRequest) => unknown | Promise<unknown>;
 export interface ProductionRuleHostGateOptions {
+    projectDir?: string;
     ruleContextProvider?: RuleContextProvider;
     ruleInputEnrichmentProvider?: RuleInputEnrichmentProvider;
     implementationRuntime?: RuleImplementationRuntime;

package/dist/production-rulehost-gate.js

@@ -81,7 +81,7 @@ export function createProductionRuleHostGate(options = {}) {
         }
         const canonicalKind = toolSemantics.resolve(input.toolName);
         const { isBashTool: isBash, isWriteTool: isWrite } = deriveToolHintsFromCanonicalKind(canonicalKind);
-        const action = buildRuleHostAction(input.toolName, input.params, event.context.workspaceDir, { isBashTool: isBash, isWriteTool: isWrite, canonicalKind });
+        const action = buildRuleHostAction(input.toolName, input.params, options.projectDir ?? event.context.workspaceDir, { isBashTool: isBash, isWriteTool: isWrite, canonicalKind });
         if (action.normalizedPath === null)
             return { decision: 'allow', source: event.source, metadata: { evaluatedLiveRules: 0 } };
         let context;

package/dist/prompt-injection-projection.d.ts

@@ -15,14 +15,14 @@ export interface PromptInjectionProjection {
     injectedActivationIds: string[];
     warnings: string[];
     /**
-     * PRI-935: the budget-packing policy that produced THIS projection
+     * PR-1894: the budget-packing policy that produced THIS projection
      * (`legacy_fifo_prefix_v1` | `fair_rotation_v1`). The console must not
      * describe a fair-rotation workspace in FIFO terms, so the policy travels
      * with the projection instead of being re-derived by each consumer.
      */
     selectionPolicy: PromptSelectionPolicy;
     /**
-     * PRI-935: activations that the production route will inject under SOME
+     * PR-1894: activations that the production route will inject under SOME
      * round key, i.e. activations that are merely rotated out of the current
      * window rather than structurally starved.
      *
@@ -38,7 +38,7 @@ export interface PromptInjectionProjection {
     /** Number of eligible candidates that reached the selector. */
     eligibleCount: number;
     /**
-     * PRI-935: whether the PRODUCTION route for this workspace rotates.
+     * PR-1894: whether the PRODUCTION route for this workspace rotates.
      * The forecast's own `selectionPolicy` answers "which policy did THIS
      * projection run", which is legacy for a console that holds no session
      * round key; this answers "will the agent's real injection rotate",
@@ -65,7 +65,7 @@ export interface PromptInjectionProjection {
  * console cannot replay that reducer read-only, so this projection may
  * forecast slightly MORE consumption than the real injection (never less).
  *
- * PRI-935 — round-key alignment. The plugin derives its fair-rotation round
+ * PR-1894 — round-key alignment. The plugin derives its fair-rotation round
  * key from the CURRENT session's turn ordinal
  * (`nextSessionTurnOrdinal`), which the console has no access to. Passing no
  * key therefore does NOT make the forecast "more conservative": it selects a
@@ -79,7 +79,7 @@ export declare function buildLivePromptInjectionProjection(input: {
     workspaceDir: string;
     excludePrincipleIds?: ReadonlySet<string>;
     /**
-     * PRI-935: the fair-rotation round key the production route is using this
+     * PR-1894: the fair-rotation round key the production route is using this
      * turn. Callers that hold one (the plugin) pass it; callers that do not
      * (the console) omit it and MUST read `selectionPolicy` off the result
      * rather than assuming FIFO.

package/dist/prompt-injection-projection.js

@@ -3,7 +3,7 @@ import { escapeXml } from '@principles/core/prompt-builder';
 import { loadPdConfigForPlugin } from './pd-config.js';
 import { buildActivePrinciplePromptContext, readPromptActivationCandidates } from './active-principle-prompt.js';
 /**
- * PRI-935: which activations a fair-rotation selector injects across the
+ * PR-1894: which activations a fair-rotation selector injects across the
  * whole ring. The plugin's round key advances by one per recorded user turn
  * within a continuously advancing session, so N consecutive turns cover all
  * N ring positions: an activation absent from the current window but present
@@ -42,7 +42,7 @@ function collectReachableActivationIds(principles, budget) {
  * console cannot replay that reducer read-only, so this projection may
  * forecast slightly MORE consumption than the real injection (never less).
  *
- * PRI-935 — round-key alignment. The plugin derives its fair-rotation round
+ * PR-1894 — round-key alignment. The plugin derives its fair-rotation round
  * key from the CURRENT session's turn ordinal
  * (`nextSessionTurnOrdinal`), which the console has no access to. Passing no
  * key therefore does NOT make the forecast "more conservative": it selects a
@@ -90,11 +90,11 @@ export async function buildLivePromptInjectionProjection(input) {
             productionRotates: false,
         };
     }
-    // PRI-935: pass the caller's round key so the forecast runs the SAME
+    // PR-1894: pass the caller's round key so the forecast runs the SAME
     // packing policy production runs this turn.
     const trimmed = trimToBudget(principles, RUNTIME_V2_PRINCIPLE_BUDGET, escapeXml, input.roundKey);
     const injected = principles.filter((p) => trimmed.injectedIds.has(p.principleId));
-    // PRI-935: the legacy_trim route IS the OpenClaw plugin-local route, which
+    // PR-1894: the legacy_trim route IS the OpenClaw plugin-local route, which
     // rotates on every recorded user turn (PRI-904). Reachability is therefore
     // computed under fair rotation regardless of whether THIS forecast holds a
     // round key — a console without a session key must still be able to tell

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/host-runtime",
-  "version": "0.7.12",
+  "version": "0.7.13",
   "description": "Shared host-neutral orchestration for Principles Disciple MVP-Core hook paths.",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,7 +21,7 @@
     "lint": "eslint \"src/**/*.ts\""
   },
   "dependencies": {
-    "@principles/core": "^1.287.7",
+    "@principles/core": "^1.289.0",
     "@principles/install-layout": "^0.2.7",
     "better-sqlite3": "^13.0.3",
     "js-yaml": "^5.4.1"