instar 0.28.113 → 0.28.114

package/dist/commands/route.js

@@ -0,0 +1,124 @@
+/**
+ * `instar route` — One-shot framework+model routing for a task description.
+ *
+ * Composition root for Phase 5b's suggest-and-confirm UX, exposed via CLI so
+ * Justin can exercise the end-to-end flow without standing up Telegram. The
+ * CLI path forces the auto-default branch by passing `telegramTopicId: null`
+ * — that yields the catalog default with `source: auto-defaulted-no-topic`,
+ * which is the deterministic, testable outcome.
+ *
+ * Wiring:
+ *   - IntelligenceProvider via `buildIntelligenceProvider({ framework })`
+ *     so a Codex-only install picks Codex; a Claude install picks Claude.
+ *   - PreferenceStore at `<stateDir>/framework-model-preferences.db`.
+ *   - StaticCatalogProvider (hand-curated Phase 5a fitness picks).
+ *   - CostStateTracker with a stub readSdkCredit (returns null until
+ *     Tier 3.C plumbs UsageMeterProvider).
+ *   - TelegramConfirmer with a no-op transport — the CLI never asks; it
+ *     short-circuits at the `no-topic` branch.
+ *
+ * Output: human-readable summary by default, JSON when `--json` is set.
+ */
+import pc from 'picocolors';
+import path from 'node:path';
+import { loadConfig, ensureStateDir } from '../core/Config.js';
+import { buildIntelligenceProvider, frameworkFromEnv, } from '../core/intelligenceProviderFactory.js';
+import { PreferenceStore } from '../providers/uxConfirm/PreferenceStore.js';
+import { TaskClassifier } from '../providers/uxConfirm/TaskClassifier.js';
+import { OverrideDetector } from '../providers/uxConfirm/OverrideDetector.js';
+import { TelegramConfirmer } from '../providers/uxConfirm/TelegramConfirmer.js';
+import { StaticCatalogProvider } from '../providers/uxConfirm/StaticCatalogProvider.js';
+import { FrameworkModelRouter } from '../providers/uxConfirm/FrameworkModelRouter.js';
+import { CostStateTracker } from '../providers/costAwareRouting.js';
+const KNOWN_FRAMEWORKS = ['claude-code', 'codex-cli', 'gemini-cli'];
+const KNOWN_MODELS = [
+    'opus-4.7',
+    'sonnet-4.6',
+    'haiku-4.5',
+    'gpt-5.3-codex',
+    'gemini-2.5-pro',
+    'deepseek-v4',
+];
+function resolveFramework(opt) {
+    if (opt) {
+        const normalized = opt.toLowerCase();
+        if (normalized === 'claude' || normalized === 'claude-code')
+            return 'claude-code';
+        if (normalized === 'codex' || normalized === 'codex-cli')
+            return 'codex-cli';
+    }
+    return frameworkFromEnv() ?? 'claude-code';
+}
+export async function route(taskPrompt, options) {
+    if (!taskPrompt || !taskPrompt.trim()) {
+        console.error(pc.red('Error: task description is required.'));
+        console.error('Usage: instar route "describe the task here"');
+        process.exit(1);
+    }
+    const config = loadConfig(options.dir);
+    ensureStateDir(config.stateDir);
+    const framework = resolveFramework(options.framework);
+    const intelligence = buildIntelligenceProvider({
+        framework,
+        binaryPath: framework === 'claude-code' ? config.sessions.claudePath : undefined,
+        workingDirectory: config.stateDir,
+    });
+    if (!intelligence) {
+        console.error(pc.red(`Error: no IntelligenceProvider available for framework "${framework}".`));
+        console.error('Check that the framework binary is installed and resolvable.');
+        process.exit(1);
+    }
+    const dbPath = path.join(config.stateDir, 'framework-model-preferences.db');
+    const store = new PreferenceStore({ dbPath });
+    const catalog = new StaticCatalogProvider();
+    const costStateTracker = new CostStateTracker({
+        readSdkCredit: async () => null, // Tier 3.C will wire UsageMeterProvider here.
+    });
+    const classifier = new TaskClassifier({ intelligence });
+    const overrideDetector = new OverrideDetector({
+        intelligence,
+        knownFrameworks: KNOWN_FRAMEWORKS,
+        knownModels: KNOWN_MODELS,
+    });
+    // No-op transport — the CLI flow never reaches awaitReply because we pass
+    // telegramTopicId: null below, which short-circuits at the no-topic gate
+    // before the confirmer is consulted. The transport is here for type
+    // soundness only.
+    const noopTransport = {
+        async send() { },
+        async awaitReply() { return null; },
+    };
+    const confirmer = new TelegramConfirmer({
+        transport: noopTransport,
+        overrideDetector,
+    });
+    const router = new FrameworkModelRouter({
+        classifier,
+        store,
+        confirmer,
+        costStateTracker,
+        catalog,
+    });
+    const result = await router.route({
+        userId: options.user ?? 'cli-user',
+        taskPrompt,
+        taskDescription: options.description ?? taskPrompt.slice(0, 80),
+        telegramTopicId: null, // CLI path → auto-default branch (no UX round-trip).
+    });
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log();
+    console.log(pc.bold('Framework + model routing result'));
+    console.log(pc.dim('─'.repeat(48)));
+    console.log(`  ${pc.cyan('Framework:')}      ${pc.bold(result.framework)}`);
+    console.log(`  ${pc.cyan('Model:')}          ${pc.bold(result.model)}`);
+    console.log(`  ${pc.cyan('Task pattern:')}   ${result.taskPattern}`);
+    console.log(`  ${pc.cyan('Source:')}         ${pc.yellow(result.source)}`);
+    console.log(`  ${pc.cyan('Catalog default:')} ${result.catalogDefault.framework} / ${result.catalogDefault.model} (${result.catalogDefault.confidence})`);
+    console.log();
+    console.log(pc.dim('Note: CLI invocation forces the no-topic branch (auto-defaults).'));
+    console.log(pc.dim('The full confirm-via-Telegram flow lands when the server endpoint wires this router.'));
+}
+//# sourceMappingURL=route.js.map

package/dist/commands/route.js.map

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

package/dist/commands/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmQH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAw4CD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAusKtE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiQH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAwnDD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAo1KtE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}