tim-hooks 0.1.0-beta.0

package/dist/phantom-recovery.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repairPhantomProjectBinding = repairPhantomProjectBinding;
+exports.stripUnboundProjectSuffix = stripUnboundProjectSuffix;
+exports.formatUnboundProjectLabel = formatUnboundProjectLabel;
+exports.isUnboundProjectLabel = isUnboundProjectLabel;
+exports.markerWithRepairedProject = markerWithRepairedProject;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const marker_js_1 = require("./marker.js");
+function readTimJsonProjectLabel(dir) {
+    const filePath = path.join(dir, marker_js_1.CANONICAL_PROJECT_FILENAME);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        const label = raw.project;
+        return typeof label === 'string' && (0, marker_js_1.validateProjectLabel)(label) ? label : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function labelIfValidProject(store, label) {
+    const validated = await (0, marker_js_1.validateMarkerAgainstStore)({
+        version: 2,
+        project: label,
+        session: '',
+        exchanges: 0,
+        batch_size: 5,
+        batches_summarized: 0,
+    }, store);
+    return validated?.project ?? null;
+}
+/**
+ * Attempt to recover a real project label when `.tim-project` points at a
+ * phantom (pattern-valid label missing from the DB).
+ */
+async function repairPhantomProjectBinding(store, dir) {
+    const resolvedDir = path.resolve(dir);
+    const fromTimJson = readTimJsonProjectLabel(resolvedDir);
+    if (fromTimJson) {
+        const label = await labelIfValidProject(store, fromTimJson);
+        if (label)
+            return label;
+    }
+    const byPath = await store.findProjectByPath(resolvedDir);
+    if (byPath && byPath.metadata.kind === 'project' && !byPath.irrelevant) {
+        const label = typeof byPath.metadata.label === 'string'
+            ? byPath.metadata.label
+            : byPath.id;
+        return label;
+    }
+    const alias = path.basename(resolvedDir).toLowerCase();
+    if (alias) {
+        const resolved = await store.resolveProjectLabel(alias);
+        if (resolved.status === 'found') {
+            const entry = await store.read(resolved.label);
+            if (entry?.metadata.kind === 'project' && !entry.irrelevant) {
+                return resolved.label;
+            }
+        }
+        // ambiguous → leave unrepaired (caller must not mint another contested alias)
+    }
+    return null;
+}
+/** Strip trailing `?` from statusline unbound display labels. */
+function stripUnboundProjectSuffix(label) {
+    return label.endsWith('?') ? label.slice(0, -1) : label;
+}
+function formatUnboundProjectLabel(label) {
+    return label.endsWith('?') ? label : `${label}?`;
+}
+function isUnboundProjectLabel(label) {
+    return label.endsWith('?');
+}
+function markerWithRepairedProject(marker, recoveredLabel) {
+    return { ...marker, project: recoveredLabel };
+}
+//# sourceMappingURL=phantom-recovery.js.map

package/dist/phantom-recovery.js.map

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

package/dist/project-creation.d.ts

@@ -0,0 +1,48 @@
+import type { Entry } from 'tim-core';
+import { TimStore } from 'tim-store';
+import { writeMarkerExclusive } from './marker.js';
+export declare const MODE_ERROR = "Exactly one creation mode is required. Pass an absolute project path for a repository/workspace, or memoryOnly: true only when no directory should be bound.";
+export interface ProjectCreationArgs {
+    label: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+    aliases?: string[];
+    path?: string;
+    memoryOnly?: boolean;
+}
+export interface MemoryOnlyProjectCreationResult extends Entry {
+    mode: 'memory-only';
+}
+export interface BoundProjectCreationResult extends Entry {
+    mode: 'bound';
+    projectPath: string;
+    markerPath: string;
+}
+export type ProjectCreationResult = MemoryOnlyProjectCreationResult | BoundProjectCreationResult;
+export interface ProjectCreationDeps {
+    sessionId: () => string;
+    writeExclusive: typeof writeMarkerExclusive;
+    preflight: typeof preflightProjectDirectory;
+}
+export interface RecoverProjectBindingArgs {
+    label: string;
+    path: string;
+    sessionId?: string;
+}
+export interface RecoverProjectBindingResult {
+    label: string;
+    projectPath: string;
+    markerPath: string;
+    alreadyBound: boolean;
+}
+export declare class ProjectCreationPartialFailureError extends Error {
+    readonly createdLabel: string;
+    readonly projectPath: string;
+    constructor(message: string, createdLabel: string, projectPath: string);
+}
+export declare function validateMode(args: ProjectCreationArgs): 'bound' | 'memory-only';
+export declare function canonicalDirectory(directory: string): string;
+export declare function preflightProjectDirectory(directory: string): void;
+export declare function createProjectCoordinated(store: TimStore, args: ProjectCreationArgs, deps?: Partial<ProjectCreationDeps>): Promise<ProjectCreationResult>;
+export declare function recoverProjectBinding(store: TimStore, args: RecoverProjectBindingArgs, deps?: Partial<ProjectCreationDeps>): Promise<RecoverProjectBindingResult>;
+//# sourceMappingURL=project-creation.d.ts.map

package/dist/project-creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-creation.d.ts","sourceRoot":"","sources":["../src/project-creation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAIL,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,UAAU,iKAAiK,CAAC;AAEzL,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,+BAAgC,SAAQ,KAAK;IAC5D,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,0BAA2B,SAAQ,KAAK;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,qBAAqB,GAC7B,+BAA+B,GAC/B,0BAA0B,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,cAAc,EAAE,OAAO,oBAAoB,CAAC;IAC5C,SAAS,EAAE,OAAO,yBAAyB,CAAC;CAC7C;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,kCAAmC,SAAQ,KAAK;aAGzC,YAAY,EAAE,MAAM;aACpB,WAAW,EAAE,MAAM;gBAFnC,OAAO,EAAE,MAAM,EACC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM;CAKtC;AAQD,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,GAAG,aAAa,CAY/E;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkB5D;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CASjE;AAmFD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,mBAAmB,EACzB,IAAI,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACtC,OAAO,CAAC,qBAAqB,CAAC,CA6EhC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,yBAAyB,EAC/B,IAAI,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACtC,OAAO,CAAC,2BAA2B,CAAC,CAoDtC"}

package/dist/project-creation.js

@@ -0,0 +1,265 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectCreationPartialFailureError = exports.MODE_ERROR = void 0;
+exports.validateMode = validateMode;
+exports.canonicalDirectory = canonicalDirectory;
+exports.preflightProjectDirectory = preflightProjectDirectory;
+exports.createProjectCoordinated = createProjectCoordinated;
+exports.recoverProjectBinding = recoverProjectBinding;
+const crypto = __importStar(require("node:crypto"));
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const marker_js_1 = require("./marker.js");
+exports.MODE_ERROR = 'Exactly one creation mode is required. Pass an absolute project path for a repository/workspace, or memoryOnly: true only when no directory should be bound.';
+class ProjectCreationPartialFailureError extends Error {
+    createdLabel;
+    projectPath;
+    constructor(message, createdLabel, projectPath) {
+        super(message);
+        this.createdLabel = createdLabel;
+        this.projectPath = projectPath;
+        this.name = 'ProjectCreationPartialFailureError';
+    }
+}
+exports.ProjectCreationPartialFailureError = ProjectCreationPartialFailureError;
+const DEFAULT_DEPS = {
+    sessionId: () => crypto.randomUUID(),
+    writeExclusive: marker_js_1.writeMarkerExclusive,
+    preflight: preflightProjectDirectory,
+};
+function validateMode(args) {
+    const hasPath = typeof args.path === 'string' && args.path.length > 0;
+    const isMemoryOnly = args.memoryOnly === true;
+    if (hasPath === isMemoryOnly) {
+        throw new Error(exports.MODE_ERROR);
+    }
+    if (isMemoryOnly && args.metadata && Object.prototype.hasOwnProperty.call(args.metadata, 'path')) {
+        throw new Error('metadata.path is service-owned and cannot be supplied in memory-only mode');
+    }
+    return isMemoryOnly ? 'memory-only' : 'bound';
+}
+function canonicalDirectory(directory) {
+    const environmentShorthand = /\$(?:\{|[A-Za-z_])|%[A-Za-z_][A-Za-z0-9_]*%/;
+    if (directory.startsWith('~') || environmentShorthand.test(directory)) {
+        throw new Error(`Project path must not use home or environment shorthand: ${directory}`);
+    }
+    if (!path.isAbsolute(directory)) {
+        throw new Error(`Pass an absolute project path; received: ${directory}`);
+    }
+    const canonical = fs.realpathSync(directory);
+    if (!fs.statSync(canonical).isDirectory()) {
+        throw new Error(`Project path must be a directory: ${directory}`);
+    }
+    if (canonical === fs.realpathSync(os.homedir())) {
+        throw new Error('The home directory cannot be bound as a project directory');
+    }
+    return canonical;
+}
+function preflightProjectDirectory(directory) {
+    const probe = path.join(directory, `.tim-write-probe.${process.pid}.${crypto.randomUUID()}`);
+    let ownsProbe = false;
+    try {
+        fs.writeFileSync(probe, '', { flag: 'wx' });
+        ownsProbe = true;
+    }
+    finally {
+        if (ownsProbe)
+            fs.rmSync(probe, { force: true });
+    }
+}
+const UNKNOWN_LOCAL_MARKER = Symbol('unknown-local-marker');
+function localMarkerLabel(projectPath) {
+    const marker = (0, marker_js_1.markerPath)(projectPath);
+    let markerStat;
+    try {
+        markerStat = fs.lstatSync(marker);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        return UNKNOWN_LOCAL_MARKER;
+    }
+    if (markerStat.isSymbolicLink()) {
+        try {
+            markerStat = fs.statSync(marker);
+        }
+        catch {
+            return UNKNOWN_LOCAL_MARKER;
+        }
+    }
+    if (!markerStat.isFile())
+        return UNKNOWN_LOCAL_MARKER;
+    return (0, marker_js_1.readMarker)(projectPath)?.project ?? UNKNOWN_LOCAL_MARKER;
+}
+function shellSingleQuote(value) {
+    return `'${value.replaceAll("'", "'\"'\"'")}'`;
+}
+function markerInput(label, session) {
+    return {
+        project: label,
+        session,
+        exchanges: 0,
+        batch_size: 5,
+        batches_summarized: 0,
+    };
+}
+function recoveryCommand(databasePath, label, projectPath) {
+    return `TIM_DB_PATH=${shellSingleQuote(databasePath)} tim bind-project --label ${shellSingleQuote(label)} --cwd ${shellSingleQuote(projectPath)}`;
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function targetMarkerConflict(markerPath, label) {
+    const owner = label === UNKNOWN_LOCAL_MARKER ? 'an unknown or corrupt marker' : `project ${label}`;
+    return new Error(`A target-local project marker already exists at ${markerPath} and belongs to ${owner}. ` +
+        'Remove it only if it is stale, or explicitly reconcile/rebind this directory before creating a project.');
+}
+function publicationFailure(databasePath, label, projectPath, reason) {
+    return new ProjectCreationPartialFailureError(`Project ${label} was created in the database, but its local marker was not published or verified at ${projectPath}: ${reason}. ` +
+        `Recover the binding with: ${recoveryCommand(databasePath, label, projectPath)}`, label, projectPath);
+}
+function publicationRace(requested, winner, projectPath) {
+    const winnerText = winner === UNKNOWN_LOCAL_MARKER ? 'an unknown or corrupt marker' : `project ${winner}`;
+    return new ProjectCreationPartialFailureError(`Project ${requested} was created in the database, but ${winnerText} won marker publication at ${projectPath}. ` +
+        `The existing marker was preserved. Explicit reconciliation is required between the requested project ${requested} and the marker winner; do not overwrite the marker.`, requested, projectPath);
+}
+async function createProjectCoordinated(store, args, deps = {}) {
+    const runtime = {
+        sessionId: deps.sessionId ?? DEFAULT_DEPS.sessionId,
+        writeExclusive: deps.writeExclusive ?? DEFAULT_DEPS.writeExclusive,
+        preflight: deps.preflight ?? DEFAULT_DEPS.preflight,
+    };
+    const mode = validateMode(args);
+    if (mode === 'memory-only') {
+        const entry = await store.createProject(args.label, {
+            content: args.content,
+            metadata: args.metadata,
+            aliases: args.aliases,
+        });
+        return { ...entry, mode };
+    }
+    if (store.getDatabasePath() === ':memory:') {
+        throw new Error('Bound projects require a persistent database. Configure TIM_DB_PATH to a filesystem database, ' +
+            'then retry; use memoryOnly:true only for an intentionally virtual project.');
+    }
+    const projectPath = canonicalDirectory(args.path);
+    if (!(0, marker_js_1.validateProjectLabel)(args.label)) {
+        throw new Error(`Invalid project label for a bound project: ${args.label}`);
+    }
+    const markerPath = (0, marker_js_1.markerPath)(projectPath);
+    const existing = localMarkerLabel(projectPath);
+    if (existing !== null) {
+        throw new Error(`${targetMarkerConflict(markerPath, existing).message} Requested project: ${args.label}.`);
+    }
+    runtime.preflight(projectPath);
+    const resolved = await store.resolveProjectLabel(args.label);
+    if (resolved.status !== 'not_found') {
+        const detail = resolved.status === 'found'
+            ? resolved.label === args.label
+                ? 'already exists'
+                : `already resolves to project ${resolved.label}`
+            : 'has an ambiguous project-label conflict';
+        throw new Error(`Project label ${args.label} ${detail}`);
+    }
+    const entry = await store.createProject(args.label, {
+        content: args.content,
+        metadata: { ...(args.metadata ?? {}), path: projectPath },
+        aliases: args.aliases,
+    });
+    try {
+        runtime.writeExclusive(projectPath, markerInput(args.label, runtime.sessionId()));
+    }
+    catch (error) {
+        const winner = localMarkerLabel(projectPath);
+        if (winner !== null && winner !== args.label) {
+            throw publicationRace(args.label, winner, projectPath);
+        }
+        if (winner !== args.label) {
+            throw publicationFailure(store.getDatabasePath(), args.label, projectPath, errorText(error));
+        }
+    }
+    const verified = localMarkerLabel(projectPath);
+    if (verified !== args.label) {
+        if (verified !== null)
+            throw publicationRace(args.label, verified, projectPath);
+        throw publicationFailure(store.getDatabasePath(), args.label, projectPath, 'the marker is absent after publication');
+    }
+    return { ...entry, mode, projectPath, markerPath };
+}
+async function recoverProjectBinding(store, args, deps = {}) {
+    const runtime = {
+        sessionId: deps.sessionId ?? DEFAULT_DEPS.sessionId,
+        writeExclusive: deps.writeExclusive ?? DEFAULT_DEPS.writeExclusive,
+        preflight: deps.preflight ?? DEFAULT_DEPS.preflight,
+    };
+    const projectPath = canonicalDirectory(args.path);
+    const markerPath = (0, marker_js_1.markerPath)(projectPath);
+    const resolved = await store.resolveProjectLabel(args.label);
+    if (resolved.status !== 'found' || resolved.label !== args.label) {
+        throw new Error(`Live project label not found: ${args.label}`);
+    }
+    const existing = localMarkerLabel(projectPath);
+    if (existing === args.label) {
+        return { label: args.label, projectPath, markerPath, alreadyBound: true };
+    }
+    if (existing !== null) {
+        throw new Error(`${targetMarkerConflict(markerPath, existing).message} Requested project: ${args.label}.`);
+    }
+    runtime.preflight(projectPath);
+    try {
+        runtime.writeExclusive(projectPath, markerInput(args.label, args.sessionId ?? runtime.sessionId()));
+    }
+    catch (error) {
+        const winner = localMarkerLabel(projectPath);
+        if (winner === args.label) {
+            return { label: args.label, projectPath, markerPath, alreadyBound: true };
+        }
+        if (winner !== null) {
+            throw new Error(`${targetMarkerConflict(markerPath, winner).message} Requested project: ${args.label}.`);
+        }
+        throw new Error(`Could not recover project binding for ${args.label} at ${projectPath}: ${errorText(error)}`);
+    }
+    const verified = localMarkerLabel(projectPath);
+    if (verified !== args.label) {
+        if (verified !== null) {
+            throw new Error(`${targetMarkerConflict(markerPath, verified).message} Requested project: ${args.label}.`);
+        }
+        throw new Error(`Could not verify recovered project binding for ${args.label} at ${projectPath}`);
+    }
+    return { label: args.label, projectPath, markerPath, alreadyBound: false };
+}
+//# sourceMappingURL=project-creation.js.map

package/dist/project-creation.js.map

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

package/dist/prompt-submit.d.ts

@@ -0,0 +1,16 @@
+import type { TimStore } from 'tim-store';
+export interface PromptSubmitParams {
+    prompt: string;
+    projectLabel?: string;
+    timeoutMs?: number;
+}
+export interface PromptSubmitResult {
+    lines: string[];
+    context: string;
+}
+/**
+ * UserPromptSubmit hook: hybrid FTS retrieval + optional guard warnings.
+ * Never throws; returns null when disabled, empty, slow, or on error.
+ */
+export declare function runPromptSubmit(store: TimStore, params: PromptSubmitParams): Promise<PromptSubmitResult | null>;
+//# sourceMappingURL=prompt-submit.d.ts.map

package/dist/prompt-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-submit.d.ts","sourceRoot":"","sources":["../src/prompt-submit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAS1C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAyDD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAWpC"}

package/dist/prompt-submit.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPromptSubmit = runPromptSubmit;
+const tim_core_1 = require("tim-core");
+const DEFAULT_TIMEOUT_MS = 1000;
+const RETRIEVAL_TOP_K = 3;
+/** Prompt looks like a planned action — run tim_guard-style failure lookup. */
+const ACTION_PATTERN = /\b(run|deploy|upload|push|delete|migrate|install|spawn|execute|commit|publish|rmapi|restart|drop|truncate)\b/i;
+function excerpt(text, max = 120) {
+    const t = text.replace(/\s+/g, ' ').trim();
+    return t.length > max ? `${t.slice(0, max - 1)}…` : t;
+}
+function looksLikeAction(prompt) {
+    return ACTION_PATTERN.test(prompt);
+}
+function raceWithTimeout(promise, timeoutMs) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => resolve(null), timeoutMs);
+        promise.then((v) => { clearTimeout(timer); resolve(v); }, () => { clearTimeout(timer); resolve(null); });
+    });
+}
+async function computePromptContext(store, params) {
+    const query = params.prompt.trim();
+    if (!query)
+        return null;
+    const lines = [];
+    let hits = await store.search({
+        query,
+        topK: RETRIEVAL_TOP_K * 3,
+        searchType: 'fts',
+    });
+    if (params.projectLabel) {
+        hits = hits.filter(e => store.getProjectLabel(e.id) === params.projectLabel);
+    }
+    for (const hit of hits.slice(0, RETRIEVAL_TOP_K)) {
+        const label = hit.title?.trim() || hit.id;
+        lines.push(`TIM erinnert: ${label} — ${excerpt(hit.content || hit.title)}`);
+    }
+    if (looksLikeAction(query)) {
+        const failures = await store.searchFailures(query, {
+            projectLabel: params.projectLabel,
+            limit: 3,
+        });
+        for (const f of failures) {
+            const kind = typeof f.metadata.kind === 'string' ? f.metadata.kind : 'warning';
+            lines.push(`TIM guard (${kind}): ${f.title} [${f.id}] — ${excerpt(f.content)}`);
+        }
+    }
+    if (lines.length === 0)
+        return null;
+    return { lines, context: lines.join('\n') };
+}
+/**
+ * UserPromptSubmit hook: hybrid FTS retrieval + optional guard warnings.
+ * Never throws; returns null when disabled, empty, slow, or on error.
+ */
+async function runPromptSubmit(store, params) {
+    const config = (0, tim_core_1.loadConfig)();
+    if (config.hooks?.promptSubmit?.enabled === false)
+        return null;
+    const timeoutMs = params.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    try {
+        return await raceWithTimeout(computePromptContext(store, params), timeoutMs);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=prompt-submit.js.map

package/dist/prompt-submit.js.map

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

package/dist/rebalance.d.ts

@@ -0,0 +1,17 @@
+import type { TimStore } from 'tim-store';
+export interface RebalanceSkip {
+    reason: 'locked' | 'single-exchange-batch' | 'unrelated' | 'no-boundary';
+    batchIndex?: number;
+}
+export interface RebalanceResult {
+    moved: number;
+    skipped: RebalanceSkip[];
+}
+/**
+ * Scan exchange-batch boundaries; move the first exchange of batch N (+ agent reply)
+ * into batch N-1 when it is topically related to the last exchange of N-1.
+ */
+export declare function rebalanceBatch(store: TimStore, sessionId: string, opts?: {
+    cwd?: string;
+}): Promise<RebalanceResult>;
+//# sourceMappingURL=rebalance.d.ts.map

package/dist/rebalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebalance.d.ts","sourceRoot":"","sources":["../src/rebalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAc1C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,GAAG,uBAAuB,GAAG,WAAW,GAAG,aAAa,CAAC;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAgCD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1B,OAAO,CAAC,eAAe,CAAC,CAuD1B"}