@cleocode/contracts 2026.5.99 → 2026.5.100

package/dist/project-tools.js

@@ -0,0 +1,14 @@
+/**
+ * ProjectTools contracts — input/output types for scaffold-project,
+ * doctor-project, and scaffold-global SDK tools.
+ *
+ * These are pure-functional, harness-agnostic operation contracts. Each
+ * tool function accepts an options bag and returns a typed result envelope —
+ * no I/O is performed inside the contract shapes themselves.
+ *
+ * Taxonomy: Category B SDK Tool (ADR-064).
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CORE-TOOLS T9835 (T9835b)
+ */
+export {};
+//# sourceMappingURL=project-tools.js.map

package/dist/project-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-tools.js","sourceRoot":"","sources":["../src/project-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/release/plan.d.ts

@@ -169,8 +169,8 @@ export declare const TaskKindSchema: z.ZodEnum<{
     refactor: "refactor";
     chore: "chore";
     breaking: "breaking";
-    revert: "revert";
     hotfix: "hotfix";
+    revert: "revert";
 }>;
 /** Zod schema for {@link IMPACT}. */
 export declare const ImpactSchema: z.ZodEnum<{
@@ -207,8 +207,8 @@ export declare const ReleasePlanTaskSchema: z.ZodObject<{
         refactor: "refactor";
         chore: "chore";
         breaking: "breaking";
-        revert: "revert";
         hotfix: "hotfix";
+        revert: "revert";
     }>;
     impact: z.ZodEnum<{
         major: "major";
@@ -372,8 +372,8 @@ export declare const ReleasePlanSchema: z.ZodObject<{
             refactor: "refactor";
             chore: "chore";
             breaking: "breaking";
-            revert: "revert";
             hotfix: "hotfix";
+            revert: "revert";
         }>;
         impact: z.ZodEnum<{
             major: "major";

package/dist/tools/brain-fetch.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Contract types for the fetchBrainEntries SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+import type { FetchBrainEntriesParams, FetchBrainEntriesResult } from '../memory/fetch.js';
+export type { FetchBrainEntriesParams, FetchBrainEntriesResult };
+/** Input accepted by the fetchBrainEntries SDK tool. */
+export interface FetchBrainEntriesInput {
+    /** Project root directory for DB resolution. */
+    projectRoot: string;
+    /** Fetch parameters forwarded to fetchBrainEntries. */
+    params: FetchBrainEntriesParams;
+}
+/** Output produced by the fetchBrainEntries SDK tool. */
+export interface FetchBrainEntriesOutput {
+    /** Result from fetchBrainEntries. */
+    result: FetchBrainEntriesResult;
+}
+//# sourceMappingURL=brain-fetch.d.ts.map

package/dist/tools/brain-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/brain-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE3F,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,CAAC;AAEjE,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAED,yDAAyD;AACzD,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,MAAM,EAAE,uBAAuB,CAAC;CACjC"}

package/dist/tools/brain-fetch.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the fetchBrainEntries SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=brain-fetch.js.map

package/dist/tools/brain-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-fetch.js","sourceRoot":"","sources":["../../src/tools/brain-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/brain-observe.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Contract types for the observeBrain SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+import type { ObserveBrainParams, ObserveBrainResult } from '../memory/observe.js';
+export type { ObserveBrainParams, ObserveBrainResult };
+/** Input accepted by the observeBrain SDK tool. */
+export interface ObserveBrainInput {
+    /** Project root directory for DB resolution. */
+    projectRoot: string;
+    /** Observation data forwarded to observeBrain. */
+    params: ObserveBrainParams;
+}
+/** Output produced by the observeBrain SDK tool. */
+export interface ObserveBrainOutput {
+    /** Result from observeBrain. */
+    result: ObserveBrainResult;
+}
+//# sourceMappingURL=brain-observe.d.ts.map

package/dist/tools/brain-observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-observe.d.ts","sourceRoot":"","sources":["../../src/tools/brain-observe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;AAEvD,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,MAAM,EAAE,kBAAkB,CAAC;CAC5B"}

package/dist/tools/brain-observe.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the observeBrain SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=brain-observe.js.map

package/dist/tools/brain-observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-observe.js","sourceRoot":"","sources":["../../src/tools/brain-observe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/brain-search.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Contract types for the searchBrain SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+import type { SearchBrainCompactParams, SearchBrainCompactResult } from '../memory/search.js';
+export type { SearchBrainCompactParams, SearchBrainCompactResult };
+/** Input accepted by the searchBrain SDK tool. */
+export interface SearchBrainInput {
+    /** Project root directory for DB resolution. */
+    projectRoot: string;
+    /** Search parameters forwarded to searchBrainCompact. */
+    params: SearchBrainCompactParams;
+}
+/** Output produced by the searchBrain SDK tool. */
+export interface SearchBrainOutput {
+    /** Compact search results from searchBrainCompact. */
+    result: SearchBrainCompactResult;
+}
+//# sourceMappingURL=brain-search.d.ts.map

package/dist/tools/brain-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-search.d.ts","sourceRoot":"","sources":["../../src/tools/brain-search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE9F,YAAY,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,CAAC;AAEnE,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,MAAM,EAAE,wBAAwB,CAAC;CAClC;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,MAAM,EAAE,wBAAwB,CAAC;CAClC"}

package/dist/tools/brain-search.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the searchBrain SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=brain-search.js.map

package/dist/tools/brain-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-search.js","sourceRoot":"","sources":["../../src/tools/brain-search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/brain-timeline.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Contract types for the timelineBrain SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+import type { TimelineBrainParams, TimelineBrainResult } from '../memory/timeline.js';
+export type { TimelineBrainParams, TimelineBrainResult };
+/** Input accepted by the timelineBrain SDK tool. */
+export interface TimelineBrainInput {
+    /** Project root directory for DB resolution. */
+    projectRoot: string;
+    /** Timeline parameters forwarded to timelineBrain. */
+    params: TimelineBrainParams;
+}
+/** Output produced by the timelineBrain SDK tool. */
+export interface TimelineBrainOutput {
+    /** Result from timelineBrain. */
+    result: TimelineBrainResult;
+}
+//# sourceMappingURL=brain-timeline.d.ts.map

package/dist/tools/brain-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/brain-timeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEtF,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAC;AAEzD,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,MAAM,EAAE,mBAAmB,CAAC;CAC7B"}

package/dist/tools/brain-timeline.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the timelineBrain SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=brain-timeline.js.map

package/dist/tools/brain-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-timeline.js","sourceRoot":"","sources":["../../src/tools/brain-timeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/build-retrieval-bundle.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Contract types for the buildRetrievalBundle SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+import type { RetrievalBundle, RetrievalRequest } from '../operations/memory.js';
+export type { RetrievalBundle, RetrievalRequest };
+/** Input accepted by the buildRetrievalBundle SDK tool. */
+export interface BuildRetrievalBundleInput {
+    /** Retrieval request forwarded to buildRetrievalBundle. */
+    req: RetrievalRequest;
+    /** Project root directory for DB resolution. */
+    projectRoot: string;
+}
+/** Output produced by the buildRetrievalBundle SDK tool. */
+export interface BuildRetrievalBundleOutput {
+    /** Fully-structured retrieval bundle with token accounting. */
+    bundle: RetrievalBundle;
+}
+//# sourceMappingURL=build-retrieval-bundle.d.ts.map

package/dist/tools/build-retrieval-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-retrieval-bundle.d.ts","sourceRoot":"","sources":["../../src/tools/build-retrieval-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC;AAElD,2DAA2D;AAC3D,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,GAAG,EAAE,gBAAgB,CAAC;IACtB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,MAAM,WAAW,0BAA0B;IACzC,+DAA+D;IAC/D,MAAM,EAAE,eAAe,CAAC;CACzB"}

package/dist/tools/build-retrieval-bundle.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the buildRetrievalBundle SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional wrapper
+ * @task T10070
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=build-retrieval-bundle.js.map

package/dist/tools/build-retrieval-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-retrieval-bundle.js","sourceRoot":"","sources":["../../src/tools/build-retrieval-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/build-task-tree.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Contract types for the buildTaskTree SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10068
+ * @epic T9835
+ */
+import type { TaskPriority } from '../task.js';
+import type { TaskTreeNode } from '../tasks.js';
+export type { TaskTreeNode };
+/** Minimal task shape required by buildTaskTree. */
+export interface BuildTaskTreeInput {
+    /** Unique task identifier. */
+    id: string;
+    /** Human-readable task title. */
+    title: string;
+    /** Current task status. */
+    status: string;
+    /** Task type classification. */
+    type?: string;
+    /** Task priority level. */
+    priority: TaskPriority;
+    /** ID of the parent task (null for root). */
+    parentId?: string | null;
+    /** Sort position within sibling scope. */
+    position?: number | null;
+    /** Dependency IDs. */
+    depends?: string[];
+    /** Additional labels. */
+    labels?: string[];
+}
+/** Options for buildTaskTree. */
+export interface BuildTaskTreeOptions {
+    /** When true, annotate each node with transitive blocker chains. */
+    withBlockers?: boolean;
+}
+/** Result of buildTaskTree. */
+export interface BuildTaskTreeResult {
+    /** Root-level tree nodes. */
+    tree: TaskTreeNode[];
+    /** Total number of nodes across all levels. */
+    totalNodes: number;
+}
+//# sourceMappingURL=build-task-tree.d.ts.map

package/dist/tools/build-task-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-task-tree.d.ts","sourceRoot":"","sources":["../../src/tools/build-task-tree.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,+BAA+B;AAC/B,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/tools/build-task-tree.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the buildTaskTree SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10068
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=build-task-tree.js.map

package/dist/tools/build-task-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-task-tree.js","sourceRoot":"","sources":["../../src/tools/build-task-tree.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/compute-critical-path.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Contract types for the computeCriticalPath SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10068
+ * @epic T9835
+ */
+/** A node in the dependency DAG. */
+export interface CriticalPathNode {
+    /** Unique task identifier. */
+    id: string;
+    /** Human-readable task title. */
+    title: string;
+    /** Current task status. */
+    status: string;
+    /** Dependency IDs (scoped to the same set of nodes). */
+    depends: string[];
+}
+/** A directed edge in the dependency DAG (dependency → dependent). */
+export interface CriticalPathEdge {
+    /** Source node ID (the dependency). */
+    from: string;
+    /** Target node ID (the dependent). */
+    to: string;
+}
+/** Result of computeCriticalPath. */
+export interface CriticalPathResult {
+    /** Ordered task IDs from path start to end (empty when graph has cycles). */
+    path: string[];
+    /** Length of the critical path. */
+    length: number;
+}
+//# sourceMappingURL=compute-critical-path.d.ts.map

package/dist/tools/compute-critical-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-critical-path.d.ts","sourceRoot":"","sources":["../../src/tools/compute-critical-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/tools/compute-critical-path.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the computeCriticalPath SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10068
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=compute-critical-path.js.map

package/dist/tools/compute-critical-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-critical-path.js","sourceRoot":"","sources":["../../src/tools/compute-critical-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/describe-schema.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Contract types for the describeSchema SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10071
+ * @epic T9835
+ */
+/** A single column in a table descriptor. */
+export interface SchemaColumn {
+    /** Column name as declared in the drizzle schema. */
+    name: string;
+    /** SQLite data type (e.g. "TEXT", "INTEGER", "REAL", "BLOB"). */
+    type: string;
+    /** True when the column has a NOT NULL constraint. */
+    notNull: boolean;
+    /** True when the column is part of the primary key. */
+    primaryKey: boolean;
+}
+/** A single index in a table descriptor. */
+export interface SchemaIndex {
+    /** Index name as declared in the drizzle schema. */
+    name: string;
+    /** True when the index enforces uniqueness. */
+    unique: boolean;
+}
+/** Descriptor for one database table. */
+export interface SchemaTableDescriptor {
+    /** Table name as stored in SQLite (snake_case). */
+    name: string;
+    /** Ordered list of column descriptors. */
+    columns: SchemaColumn[];
+    /** List of indexes defined on this table (may be empty). */
+    indexes: SchemaIndex[];
+}
+/** Full output of describeSchema — all tables in the drizzle schema. */
+export interface SchemaDescriptor {
+    /** One entry per drizzle table exported from the schema barrel. */
+    tables: SchemaTableDescriptor[];
+}
+//# sourceMappingURL=describe-schema.d.ts.map

package/dist/tools/describe-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-schema.d.ts","sourceRoot":"","sources":["../../src/tools/describe-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,4DAA4D;IAC5D,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC"}

package/dist/tools/describe-schema.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the describeSchema SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10071
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=describe-schema.js.map

package/dist/tools/describe-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-schema.js","sourceRoot":"","sources":["../../src/tools/describe-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SDK Tool contract types.
+ *
+ * @arch Contracts barrel for Category B SDK Tools in packages/core/src/tools/
+ * @task T10068
+ * @task T10070
+ * @epic T9835
+ */
+export type { FetchBrainEntriesInput, FetchBrainEntriesOutput } from './brain-fetch.js';
+export type { ObserveBrainInput, ObserveBrainOutput } from './brain-observe.js';
+export type { SearchBrainInput, SearchBrainOutput } from './brain-search.js';
+export type { TimelineBrainInput, TimelineBrainOutput } from './brain-timeline.js';
+export type { BuildRetrievalBundleInput, BuildRetrievalBundleOutput, } from './build-retrieval-bundle.js';
+export type { BuildTaskTreeInput, BuildTaskTreeOptions, BuildTaskTreeResult, } from './build-task-tree.js';
+export type { CriticalPathEdge, CriticalPathNode, CriticalPathResult, } from './compute-critical-path.js';
+export type { SchemaColumn, SchemaDescriptor, SchemaIndex, SchemaTableDescriptor, } from './describe-schema.js';
+export type { RenderTaskTreeInput } from './render-task-tree.js';
+export type { ScoreFactor, ScoreTaskContext, ScoreTaskInput, ScoreTaskResult, } from './score-task-priority.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACxF,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACnF,YAAY,EACV,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AAGrC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,0BAA0B,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,10 @@
+/**
+ * SDK Tool contract types.
+ *
+ * @arch Contracts barrel for Category B SDK Tools in packages/core/src/tools/
+ * @task T10068
+ * @task T10070
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/tools/render-task-tree.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Contract types for the renderTaskTree SDK tools.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10068
+ * @epic T9835
+ */
+import type { CriticalPathEdge, CriticalPathNode } from './compute-critical-path.js';
+/** Input to both text and Mermaid renderers. */
+export interface RenderTaskTreeInput {
+    /** Task nodes to render. */
+    nodes: CriticalPathNode[];
+    /** Directed edges between nodes. */
+    edges: CriticalPathEdge[];
+    /** Task IDs on the critical path (highlighted in output). */
+    criticalPath: string[];
+}
+//# sourceMappingURL=render-task-tree.d.ts.map

package/dist/tools/render-task-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-task-tree.d.ts","sourceRoot":"","sources":["../../src/tools/render-task-tree.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAErF,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,oCAAoC;IACpC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/tools/render-task-tree.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the renderTaskTree SDK tools.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10068
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=render-task-tree.js.map

package/dist/tools/render-task-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-task-tree.js","sourceRoot":"","sources":["../../src/tools/render-task-tree.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/score-task-priority.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Contract types for the scoreTask SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10068
+ * @epic T9835
+ */
+import type { TaskPriority } from '../task.js';
+/** Minimal task shape required by scoreTask. */
+export interface ScoreTaskInput {
+    /** Unique task identifier. */
+    id: string;
+    /** Human-readable task title. */
+    title: string;
+    /** Task priority level. */
+    priority: TaskPriority;
+    /** Phase slug this task belongs to. */
+    phase?: string;
+    /** Dependency IDs. */
+    depends?: string[];
+    /** ISO timestamp of task creation. */
+    createdAt?: string;
+    /** Labels for pattern matching. */
+    labels?: string[];
+}
+/** Context provided to scoreTask to enable phase-aware and dependency-aware scoring. */
+export interface ScoreTaskContext {
+    /** Current project phase slug (used for phase alignment bonus). */
+    currentPhase?: string | null;
+    /** Map of all task IDs to their statuses (used for dep readiness check). */
+    taskStatuses?: Map<string, string>;
+    /** Current timestamp (ms since epoch) — defaults to Date.now() when omitted. */
+    nowMs?: number;
+    /** Matched success patterns from BRAIN (optional bonus scoring). */
+    successPatterns?: Array<{
+        pattern: string;
+    }>;
+    /** Matched failure patterns from BRAIN (optional penalty scoring). */
+    failurePatterns?: Array<{
+        pattern: string;
+    }>;
+}
+/** A scoring factor contributing to the final score. */
+export interface ScoreFactor {
+    /** Factor name (e.g. "priority", "phaseAlignment"). */
+    name: string;
+    /** Numeric contribution (positive = bonus, negative = penalty). */
+    delta: number;
+    /** Human-readable explanation. */
+    detail: string;
+}
+/** Result of scoreTask. */
+export interface ScoreTaskResult {
+    /** Final computed score. */
+    score: number;
+    /** Individual scoring factors. */
+    factors: ScoreFactor[];
+}
+//# sourceMappingURL=score-task-priority.d.ts.map

package/dist/tools/score-task-priority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-task-priority.d.ts","sourceRoot":"","sources":["../../src/tools/score-task-priority.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,sEAAsE;IACtE,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2BAA2B;AAC3B,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB"}

package/dist/tools/score-task-priority.js

@@ -0,0 +1,9 @@
+/**
+ * Contract types for the scoreTask SDK tool.
+ *
+ * @arch SDK Tool (Category B) — harness-agnostic, pure-functional
+ * @task T10068
+ * @epic T9835
+ */
+export {};
+//# sourceMappingURL=score-task-priority.js.map

package/dist/tools/score-task-priority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-task-priority.js","sourceRoot":"","sources":["../../src/tools/score-task-priority.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.5.99",
+  "version": "2026.5.100",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -138,7 +138,7 @@
   "dependencies": {
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.2",
-    "@cleocode/lafs": "2026.5.99"
+    "@cleocode/lafs": "2026.5.100"
   },
   "scripts": {
     "build": "tsc -b --force && node scripts/emit-schemas.mjs",