@sentropic/focus 0.3.0 → 0.5.0-rc.3

package/README.md

@@ -5,6 +5,15 @@ A **focused-session document runtime** — the read-only **FocusSnapshot** rende
 to orient/steer it (decide being one modality among orient / amend / comment). See
 `spec/SPEC_VOL_FOCUS.md`.
 
+Decision presentation now requires the [readability gate](READABILITY.md): a literal
+owner request, plain stakes, short explicit questions/options, a recommendation,
+reading estimates and a visible glossary for codes. Public renderers refuse before
+host hooks run. `@sentropic/focus/validate` exports
+`validateDecisionDossierForPresentation` and `assertDecisionDossierForPresentation`.
+The schema additions are optional, and `validateDecisionDossierDocument` still
+accepts historical data. Legacy Track projections cannot be presented until they
+supply this information; Focus never invents an owner request to pass the gate.
+
 This package is **private** (`"private": true`) and **app-local-first**: it is not yet published.
 It is extracted to `@sentropic/focus` on npm only once a real external consumer wires it
 (repo real-consumption rule).

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAiBH,iFAAiF;AACjF,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AA2G3C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAiBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,SACR,SAAS,MAAM,EAAE,SACjB,YAAY,KACjB,QAAQ,MAAM,CAkDhB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAiBH,iFAAiF;AACjF,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AA2G3C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAiBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,GACd,MAAM,SAAS,MAAM,EAAE,EACvB,OAAM,YAAiB,KACtB,OAAO,CAAC,MAAM,CAkDhB,CAAC"}

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  * `@sentropic/track/read` `DecisionDossierView` + `amendmentTrace` (L2 replaced L1's local
  * `DecisionDossierViewFixture` type + mapper).
  */
-export type { Affordance, AmendmentStep, AmendmentTraceNode, ComprehensionEvidence, DecisionDossierDocument, DiagramNode, DiagramSyntax, FocusNode, FocusProvenance, FocusRef, OptionAnnotationState, OptionNode, OptionSetNode, OutcomeModality, OutcomeNode, ProseNode, QuestionNode, QuestionValidationState, TargetRef, } from "./model.js";
+export type { Affordance, AmendmentStep, AmendmentTraceNode, ComprehensionEvidence, DecisionDossierDocument, DiagramNode, DiagramSyntax, DossierReadability, FocusNode, FocusProvenance, FocusRef, GlossaryEntry, OptionAnnotationState, OptionNode, OptionSetNode, OutcomeModality, OutcomeNode, ProseNode, QuestionNode, QuestionValidationState, TargetRef, } from "./model.js";
 export type { HtmlRenderHooks, MdRenderHooks, RenderMarkdown, SanitizeHtml, } from "./render/hooks.js";
 export { renderTerminal } from "./render/terminal.js";
 export type { TerminalRenderOptions } from "./render/terminal.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,QAAQ,EACR,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA+BH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiCH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/model.d.ts

@@ -37,6 +37,8 @@ interface FocusNodeBase {
 export interface ProseNode extends FocusNodeBase {
     readonly kind: "prose";
     readonly markdown: string;
+    /** Explicit question covered by any choice discussed in this prose. */
+    readonly questionId?: string;
 }
 /** A question with a recommended answer (préco) and a validation state. */
 export interface QuestionNode extends FocusNodeBase {
@@ -44,9 +46,22 @@ export interface QuestionNode extends FocusNodeBase {
     readonly question: string;
     /** The recommended answer (préco). Optional — a question may be open with no préco yet. */
     readonly recommendedAnswer?: string;
+    /** Recommended option among those linked to this question; reason in recommendedAnswer. */
+    readonly recommendedOptionId?: string;
     /** The actual answer, when answered. */
     readonly answer?: string;
     readonly state: QuestionValidationState;
+    /**
+     * Readability: the decision context in plain words (what the owner needs to
+     * know to answer in ~2 minutes). Optional at schema level; the readability
+     * gate requires it before presentation.
+     */
+    readonly context?: string;
+    /**
+     * Readability: estimated reading time for this question (minutes, ≤ 2).
+     * Optional at schema level; the readability gate requires it.
+     */
+    readonly readingTimeMinutes?: number;
 }
 /** A single option/proposal/alternative with a Claude-style annotation state. */
 export interface OptionNode extends FocusNodeBase {
@@ -56,18 +71,31 @@ export interface OptionNode extends FocusNodeBase {
     readonly annotation: OptionAnnotationState;
     /** Optional free-text comment carried with a `comment` annotation. */
     readonly annotationComment?: string;
+    /**
+     * Readability: the one-line consequence of this option for the owner.
+     * Optional at schema level; the readability gate requires it.
+     */
+    readonly consequence?: string;
 }
 /** A set of mutually-related options/proposals. */
 export interface OptionSetNode extends FocusNodeBase {
     readonly kind: "optionSet";
     readonly title?: string;
     readonly options: readonly OptionNode[];
+    /**
+     * Readability: the id of the explicit question these options answer.
+     * Optional at schema level; the readability gate requires it so no choice
+     * is ever implied without an explicit question (no hidden decision).
+     */
+    readonly questionId?: string;
 }
 /** The modality-tagged outcome of the focus. */
 export interface OutcomeNode extends FocusNodeBase {
     readonly kind: "outcome";
     readonly modality: OutcomeModality;
     readonly statement: string;
+    /** The explicit question this decision, orientation or amendment resolves. */
+    readonly questionId?: string;
 }
 /** One ordered step of the amendment trace. */
 export interface AmendmentStep {
@@ -86,6 +114,9 @@ export interface DiagramNode extends FocusNodeBase {
     readonly syntax: DiagramSyntax;
     readonly source: string;
     readonly alt: string;
+    /** diagram-core SemanticDocument, generic@1, without views/geometry/layout hints.
+     * Kept as plain JSON until the private DS package publishes its schema. */
+    readonly scene?: Readonly<Record<string, unknown>>;
 }
 /** The node families needed to render a decision-dossier. */
 export type FocusNode = ProseNode | QuestionNode | OptionSetNode | OutcomeNode | AmendmentTraceNode | DiagramNode;
@@ -96,7 +127,11 @@ export type FocusNode = ProseNode | QuestionNode | OptionSetNode | OutcomeNode |
  */
 export interface Affordance {
     readonly name: string;
-    /** The target this affordance would act on (a node's targetRef). */
+    /**
+     * The target this affordance would act on. Resolves to the dossier `ref`
+     * (whole-dossier amend), a section `id`/`targetRef`, or a nested option
+     * `id`/`targetRef` — the same resolution scope the validator enforces.
+     */
     readonly targetRef: TargetRef;
     /** Human-readable label for the disabled-affordance metadata. */
     readonly label: string;
@@ -121,6 +156,37 @@ export interface FocusProvenance {
     readonly readAt: string;
     readonly comprehensionEvidence?: ComprehensionEvidence;
 }
+/** One glossary entry: an opaque code mapped to plain words for the reader. */
+export interface GlossaryEntry {
+    readonly term: string;
+    readonly definition: string;
+}
+/**
+ * Dossier-level readability statement: owner traceability, plain-words stakes,
+ * the reading budget the per-question times must fit, and the glossary that
+ * defines every code shown to the reader. Entirely optional at schema level
+ * (backward compatible); the readability gate requires it before presentation.
+ */
+export interface DossierReadability {
+    /**
+     * The owner's literal request this dossier serves, quoted verbatim
+     * (traceability). Exactly one of `ownerRequestQuote` / `noOwnerRequest`.
+     */
+    readonly ownerRequestQuote?: string;
+    /**
+     * Explicit flag: no owner request backs this dossier. Blocks presentation
+     * until a request is quoted — never present a dossier carrying it.
+     */
+    readonly noOwnerRequest?: boolean;
+    /** Why this matters to the owner, in plain words (not internal jargon). */
+    readonly stakes?: string;
+    /** Declared impact: low (reversible), medium (cost/disruption), high (lasting impact). */
+    readonly stakesLevel?: "low" | "medium" | "high";
+    /** Total reading budget in minutes (≤ 30), proportionate to the stakes. */
+    readonly readingBudgetMinutes?: number;
+    /** Every code shown to the reader, defined in plain words. */
+    readonly glossary?: readonly GlossaryEntry[];
+}
 /**
  * The CONCRETE decision-dossier document — a FocusDocument whose primary outcome modality is a
  * decision. Maps to track `DecisionDossierView{outcome,dossier,comprehensionEvidence}` +
@@ -139,6 +205,12 @@ export interface DecisionDossierDocument {
     readonly interactions: readonly Affordance[];
     readonly provenance: FocusProvenance;
     readonly amendmentTrace: readonly AmendmentStep[];
+    /**
+     * Readability statement. Optional at schema level (backward compatible);
+     * the readability gate (`@sentropic/focus/validate`) requires it and
+     * refuses presentation without it.
+     */
+    readonly readability?: DossierReadability;
 }
 export {};
 //# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,iFAAiF;AACjF,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAEnF,8FAA8F;AAC9F,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnD,2EAA2E;AAC3E,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAExE,kFAAkF;AAClF,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7E,0FAA0F;AAC1F,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,4FAA4F;AAC5F,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2FAA2F;IAC3F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,2FAA2F;IAC3F,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,wCAAwC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,iFAAiF;AACjF,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,sEAAsE;IACtE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;+EAC2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,YAAY,GACZ,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,WAAW,CAAC;AAEhB;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CACxD;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjD,2EAA2E;IAC3E,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IACxC,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;IAClD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC3C"}

package/dist/registry/definitions.d.ts

@@ -0,0 +1,159 @@
+/**
+ * `@sentropic/focus/registry/definitions` — the publisher-owned definition
+ * surface for the `sentropic.focus` skill entry (contract §§3–4, R4).
+ *
+ * This module is SIDE-EFFECT-FREE: importing it reads no file, opens no
+ * handle and touches no network. The JSON manifest is read only when
+ * {@link loadFocusSkillDescriptor} is called; instruction text is read only
+ * through the caller-supplied loader in {@link resolveFocusPresentation},
+ * and only AFTER the presentation preflight succeeds — so an unavailable
+ * presentation refuses with `unsupported_presentation` with zero instruction
+ * loads.
+ */
+/** Canonical registry ID of the Focus skill. */
+export declare const FOCUS_SKILL_ID = "sentropic.focus";
+/** Public entry version of the first Focus registry release. */
+export declare const FOCUS_ENTRY_VERSION = "1.0.0";
+/** Entry-contract version this descriptor conforms to. */
+export declare const FOCUS_CONTRACT_VERSION = "1.1.4";
+/** Parameter-schema version of the Focus entry (contract §5.4). */
+export declare const FOCUS_PARAMETERS_SCHEMA_VERSION = "1.0.0";
+/** Existing skill-description limit enforced by the contract. */
+export declare const MAX_SKILL_DESCRIPTION_LENGTH = 280;
+export type FocusPresentation = "terminal" | "markdown" | "html" | "mcp-app";
+export type FocusLocale = "en" | "fr";
+export interface FocusParameters {
+    readonly mode: "snapshot";
+    readonly preferredPresentation: FocusPresentation;
+    readonly locale: FocusLocale;
+}
+/** Exact §5.4 defaults, applied once before validation. */
+export declare const FOCUS_PARAMETER_DEFAULTS: FocusParameters;
+export interface DefinitionIssue {
+    readonly path: string;
+    readonly code: string;
+    readonly message: string;
+}
+export type DefinitionResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly issues: readonly DefinitionIssue[];
+};
+export interface FocusAsset {
+    readonly role: string;
+    readonly path: string;
+    readonly mediaType: string;
+    readonly sha256: string;
+}
+export interface FocusDocumentSchemaRef {
+    readonly name: string;
+    readonly schemaId: string;
+    readonly version: string;
+    readonly assetPath: string;
+    readonly sha256: string;
+}
+export interface FocusSkillPayload {
+    readonly profile: "instructions";
+    readonly metadata: {
+        readonly category: string;
+        readonly contextFilters: readonly string[];
+        readonly permissions: readonly string[];
+        readonly toolNames: readonly string[];
+    };
+    readonly instructionsAsset: string;
+    readonly capabilities: ReadonlyArray<{
+        readonly id: string;
+        readonly description: string;
+        readonly effect: "read-only" | "mutation";
+        readonly permissions: readonly string[];
+        readonly inputSchemaRef?: string;
+        readonly outputSchemaRef?: string;
+    }>;
+    readonly tools: readonly unknown[];
+    readonly documentSchemas: readonly FocusDocumentSchemaRef[];
+    readonly dependencies: readonly unknown[];
+}
+export interface FocusEntryDescriptor {
+    readonly format: "sentropic.registry-entry/v1";
+    readonly contractVersion: string;
+    readonly kind: "skill";
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly entryVersion: string;
+    readonly publisher: {
+        readonly packageName: string;
+        readonly packageVersion: string;
+    };
+    readonly compatibility: {
+        readonly entryContract: string;
+        readonly packages: ReadonlyArray<{
+            readonly name: string;
+            readonly range: string;
+        }>;
+        readonly schemaProfiles: readonly string[];
+        readonly requiredHostFeatures: readonly string[];
+        readonly optionalHostFeatures: readonly string[];
+    };
+    readonly parameters: {
+        readonly schemaVersion: string;
+        readonly schema: Record<string, unknown>;
+        readonly defaults: Record<string, unknown>;
+    };
+    readonly bindings: readonly unknown[];
+    readonly assets: readonly FocusAsset[];
+    readonly skill: FocusSkillPayload;
+}
+/**
+ * Closed validation of the publisher-owned Focus entry descriptor.
+ * Pure: no I/O, so catalog-time checks perform zero instruction reads.
+ */
+export declare const validateFocusEntryDescriptor: (value: unknown) => DefinitionResult<FocusEntryDescriptor>;
+/**
+ * Validate Focus configuration values against the exact §5.4 profile.
+ * Declared defaults apply once before validation; unknown keys refuse.
+ */
+export declare const validateFocusParameters: (value: unknown) => DefinitionResult<FocusParameters>;
+export interface PresentationGate {
+    /** True when the host registry holds a UI entry for Focus. */
+    readonly uiRegistered: boolean;
+    /** True when the host selected that UI entry for this session. */
+    readonly uiSelected: boolean;
+    /** True when the host qualified the selected UI entry. */
+    readonly uiQualified: boolean;
+    /** True only when the host supplies an HTML sanitization hook. */
+    readonly htmlSanitizerAvailable: boolean;
+}
+export type PresentationResolution = {
+    readonly ok: true;
+    readonly instructions: string;
+} | {
+    readonly ok: false;
+    readonly code: "unsupported_presentation";
+    readonly message: string;
+};
+/**
+ * Presentation preflight for the selected Focus configuration.
+ * `loadInstructions` runs ONLY when the requested presentation is usable, so
+ * an unavailable `mcp-app` (or an unsanitized `html`) refuses with
+ * `unsupported_presentation` with zero instruction reads/loads.
+ */
+export declare const resolveFocusPresentation: (params: FocusParameters, gate: PresentationGate, loadInstructions: () => string) => PresentationResolution;
+/**
+ * Read the package-owned registry manifest (`registry/entries.v1.json`).
+ * Called explicitly by the host; importing this module alone reads nothing.
+ *
+ * The compiled snapshot vendored into `@sentropic/track`
+ * (`packages/track/src/focus-vendor/registry/entries.v1.json`) ships the
+ * pinned 1.0.0 manifest alongside the compiled helper, so the vendor never
+ * resolves a foreign `@sentropic/focus` copy: package layout first,
+ * vendor-adjacent manifest second, and no cross-package fallback.
+ */
+export declare const loadFocusSkillDescriptor: () => unknown;
+/** Recompute every asset/schema digest over the supplied bytes. */
+export declare const verifyAssetDigests: (entry: FocusEntryDescriptor, readFile: (packageRelativePath: string) => Uint8Array | null) => DefinitionIssue[];
+/** Refuse absolute paths, traversal, escapes and duplicates. */
+export declare const assertSafeAssetPaths: (entry: Pick<FocusEntryDescriptor, "assets">) => DefinitionIssue[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/registry/definitions.d.ts.map

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