refactor(prism-facet): become a pure registration framework

Strip all Hangman-Lab-specific content out of PrismFacet so it can be
reused by any project. Content (always router, pcexec-convention prompt,
fabric-chat-injector hook) moves to the new sibling plugin ClawPrompts.

Mechanism additions:
- `globalThis.__prismFacet` cross-plugin API installed at module-import
  time (so consumers loaded before PrismFacet can still register):
    .addRouter(name, resolveFn)
    .addRule(router, key, { file })
- core/rule-store: tier rules into `persistent` (rules.json, mutated by
  the prompt-rules admin tool) and `external` (in-memory, registered by
  other plugins via the API). Persistent overrides external on conflict.
- core/router-loader: addExternalRouter() for programmatic registration
  into the same map the file-based loader uses.
- index.ts: drops registerFabricChatInjector wiring, registerBeforePromptBuild
  remains.

Removed (now shipped from ClawPrompts):
- plugin/routers/always.ts
- plugin/hooks/fabric-chat-injector.ts
- plugin/prompts/pcexec-convention.md
- plugin/rules.json: now `{}`; ClawPrompts registers its rule externally

What still lives in PrismFacet:
- before_prompt_build hook (the wiring between routers/rules and the
  agent's system prompt)
- prompt-rules admin tool (lists + mutates persistent rules)
- file-based routersDir / rulesFile scanning (kept for operator ad-hoc
  use; ClawPrompts uses the API instead)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
h z
2026-05-25 10:19:39 +01:00
parent b0fd02c50b
commit 241cced780
11 changed files with 175 additions and 146 deletions

View File

@@ -1,16 +1,34 @@
/**
* Two-tier rule store: persistent (operator/admin rules loaded from
* rules.json, mutated by the prompt-rules tool) and external (in-memory
* rules registered by other plugins via the __prismFacet cross-plugin
* API). External rules are NOT saved to disk — they belong to the
* registering plugin and are re-registered on every gateway start.
*
* Lookup precedence: persistent > external (operator wins over plugin
* defaults so an explicit rules.json override is honored).
*/
import { readFileSync, writeFileSync } from "node:fs";
export type RuleStore = Record<string, string>; // "router:key" → prompt file path
const _G = globalThis as Record<string, unknown>;
const RULES_KEY = "_prismFacetRules";
const PERSISTENT_KEY = "_prismFacetRules";
const EXTERNAL_KEY = "_prismFacetExternalRules";
const RULES_PATH_KEY = "_prismFacetRulesPath";
function getRules(): RuleStore {
if (!_G[RULES_KEY] || typeof _G[RULES_KEY] !== "object") {
_G[RULES_KEY] = {};
function getPersistent(): RuleStore {
if (!_G[PERSISTENT_KEY] || typeof _G[PERSISTENT_KEY] !== "object") {
_G[PERSISTENT_KEY] = {};
}
return _G[RULES_KEY] as RuleStore;
return _G[PERSISTENT_KEY] as RuleStore;
}
function getExternal(): RuleStore {
if (!_G[EXTERNAL_KEY] || typeof _G[EXTERNAL_KEY] !== "object") {
_G[EXTERNAL_KEY] = {};
}
return _G[EXTERNAL_KEY] as RuleStore;
}
function getRulesPath(): string {
@@ -20,26 +38,32 @@ function getRulesPath(): string {
function save(): void {
const p = getRulesPath();
if (!p) return;
writeFileSync(p, JSON.stringify(getRules(), null, 2) + "\n", "utf8");
writeFileSync(p, JSON.stringify(getPersistent(), null, 2) + "\n", "utf8");
}
export function initRuleStore(filePath: string): void {
_G[RULES_PATH_KEY] = filePath;
try {
const raw = readFileSync(filePath, "utf8");
_G[RULES_KEY] = JSON.parse(raw) as RuleStore;
_G[PERSISTENT_KEY] = JSON.parse(raw) as RuleStore;
} catch {
_G[RULES_KEY] = {};
_G[PERSISTENT_KEY] = {};
}
}
/** Operator-facing addRule (writes through to rules.json on disk). */
export function addRule(router: string, key: string, promptFile: string): void {
getRules()[`${router}:${key}`] = promptFile;
getPersistent()[`${router}:${key}`] = promptFile;
save();
}
/** Cross-plugin API: register a rule that lives in memory only. */
export function addExternalRule(router: string, key: string, promptFile: string): void {
getExternal()[`${router}:${key}`] = promptFile;
}
export function removeRule(router: string, key: string): boolean {
const rules = getRules();
const rules = getPersistent();
const ruleKey = `${router}:${key}`;
if (!(ruleKey in rules)) return false;
delete rules[ruleKey];
@@ -47,10 +71,22 @@ export function removeRule(router: string, key: string): boolean {
return true;
}
/** Lookup. Persistent (rules.json) overrides external (plugin defaults). */
export function getRule(router: string, key: string): string | undefined {
return getRules()[`${router}:${key}`];
const persistentValue = getPersistent()[`${router}:${key}`];
if (persistentValue) return persistentValue;
return getExternal()[`${router}:${key}`];
}
/** Merged view for the admin tool. Persistent overrides external. */
export function listRules(): Record<string, string> {
return { ...getRules() };
return { ...getExternal(), ...getPersistent() };
}
/** Admin tool needs to know which tier a rule came from. */
export function listRulesTiered(): {
persistent: RuleStore;
external: RuleStore;
} {
return { persistent: { ...getPersistent() }, external: { ...getExternal() } };
}