superintent 0.0.1

package/dist/db/client.d.ts

@@ -0,0 +1,4 @@
+import { Client } from '@libsql/client';
+export declare function getClient(): Promise<Client>;
+export declare function createClientWithConfig(url: string, authToken?: string): Promise<Client>;
+export declare function closeClient(): void;

package/dist/db/client.js

@@ -0,0 +1,26 @@
+import { createClient } from '@libsql/client';
+import { loadConfig } from '../utils/config.js';
+let client = null;
+export async function getClient() {
+    if (client) {
+        return client;
+    }
+    const config = loadConfig();
+    client = createClient({
+        url: config.url,
+        ...(config.authToken && { authToken: config.authToken }),
+    });
+    return client;
+}
+export async function createClientWithConfig(url, authToken) {
+    return createClient({
+        url,
+        ...(authToken && { authToken }),
+    });
+}
+export function closeClient() {
+    if (client) {
+        client.close();
+        client = null;
+    }
+}

package/dist/db/init-schema.d.ts

@@ -0,0 +1,2 @@
+import { Client } from '@libsql/client';
+export declare function initSchema(client: Client): Promise<void>;

package/dist/db/init-schema.js

@@ -0,0 +1,28 @@
+import { CREATE_TICKETS_TABLE, CREATE_TICKETS_INDEXES, CREATE_KNOWLEDGE_TABLE, CREATE_KNOWLEDGE_INDEXES, CREATE_VECTOR_INDEX, CREATE_SPECS_TABLE, CREATE_SPECS_INDEXES, } from './schema.js';
+export async function initSchema(client) {
+    // Create tickets table
+    await client.execute(CREATE_TICKETS_TABLE);
+    const ticketIndexes = CREATE_TICKETS_INDEXES.split(';').filter(s => s.trim());
+    for (const stmt of ticketIndexes) {
+        await client.execute(stmt);
+    }
+    // Create knowledge table
+    await client.execute(CREATE_KNOWLEDGE_TABLE);
+    const knowledgeIndexes = CREATE_KNOWLEDGE_INDEXES.split(';').filter(s => s.trim());
+    for (const stmt of knowledgeIndexes) {
+        await client.execute(stmt);
+    }
+    // Vector index
+    try {
+        await client.execute(CREATE_VECTOR_INDEX);
+    }
+    catch {
+        console.warn('Warning: Could not create vector index.');
+    }
+    // Create specs table
+    await client.execute(CREATE_SPECS_TABLE);
+    const specIndexes = CREATE_SPECS_INDEXES.split(';').filter(s => s.trim());
+    for (const stmt of specIndexes) {
+        await client.execute(stmt);
+    }
+}

package/dist/db/parsers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared database row parsers for Ticket, Knowledge, and SearchResult types.
+ * Consolidates duplicated parsing logic from command files.
+ */
+import type { Ticket, Knowledge, SearchResult, Spec } from '../types.js';
+/**
+ * Parse a database row into a Ticket object.
+ * Handles JSON parsing for array/object fields.
+ */
+export declare function parseTicketRow(row: Record<string, unknown>): Ticket;
+/**
+ * Parse a database row into a Knowledge object.
+ * Handles JSON parsing for tags array and provides defaults.
+ */
+export declare function parseKnowledgeRow(row: Record<string, unknown>): Knowledge;
+/**
+ * Parse a database row into a Spec object.
+ */
+export declare function parseSpecRow(row: Record<string, unknown>): Spec;
+/**
+ * Parse a database row from a vector search into a SearchResult.
+ * Converts distance to similarity score (1 - distance).
+ */
+export declare function parseSearchRow(row: Record<string, unknown>): SearchResult;

package/dist/db/parsers.js

@@ -0,0 +1,79 @@
+/**
+ * Shared database row parsers for Ticket, Knowledge, and SearchResult types.
+ * Consolidates duplicated parsing logic from command files.
+ */
+/**
+ * Parse a database row into a Ticket object.
+ * Handles JSON parsing for array/object fields.
+ */
+export function parseTicketRow(row) {
+    return {
+        id: row.id,
+        type: row.type,
+        title: row.title,
+        status: row.status,
+        intent: row.intent,
+        context: row.context,
+        constraints_use: row.constraints_use ? JSON.parse(row.constraints_use) : undefined,
+        constraints_avoid: row.constraints_avoid ? JSON.parse(row.constraints_avoid) : undefined,
+        assumptions: row.assumptions ? JSON.parse(row.assumptions) : undefined,
+        tasks: row.tasks ? JSON.parse(row.tasks) : undefined,
+        definition_of_done: row.definition_of_done ? JSON.parse(row.definition_of_done) : undefined,
+        change_class: row.change_class,
+        change_class_reason: row.change_class_reason,
+        plan: row.plan ? JSON.parse(row.plan) : undefined,
+        origin_spec_id: row.origin_spec_id,
+        derived_knowledge: row.derived_knowledge ? JSON.parse(row.derived_knowledge) : undefined,
+        comments: row.comments ? JSON.parse(row.comments) : undefined,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    };
+}
+/**
+ * Parse a database row into a Knowledge object.
+ * Handles JSON parsing for tags array and provides defaults.
+ */
+export function parseKnowledgeRow(row) {
+    return {
+        id: row.id,
+        namespace: row.namespace,
+        chunk_index: row.chunk_index,
+        title: row.title,
+        content: row.content,
+        category: row.category,
+        tags: row.tags ? JSON.parse(row.tags) : undefined,
+        source: row.source || 'manual',
+        origin_ticket_id: row.origin_ticket_id,
+        origin_ticket_type: row.origin_ticket_type,
+        confidence: row.confidence,
+        active: Boolean(row.active),
+        decision_scope: row.decision_scope || 'global',
+        usage_count: row.usage_count || 0,
+        last_used_at: row.last_used_at,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    };
+}
+/**
+ * Parse a database row into a Spec object.
+ */
+export function parseSpecRow(row) {
+    return {
+        id: row.id,
+        title: row.title,
+        content: row.content,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    };
+}
+/**
+ * Parse a database row from a vector search into a SearchResult.
+ * Converts distance to similarity score (1 - distance).
+ */
+export function parseSearchRow(row) {
+    const distance = row.distance;
+    return {
+        ...parseKnowledgeRow(row),
+        score: 1 - distance,
+    };
+}

package/dist/db/schema.d.ts

@@ -0,0 +1,7 @@
+export declare const CREATE_TICKETS_TABLE = "\nCREATE TABLE IF NOT EXISTS tickets (\n  id TEXT PRIMARY KEY,\n  type TEXT,\n  title TEXT,\n  status TEXT NOT NULL DEFAULT 'Backlog',\n  intent TEXT NOT NULL,\n  context TEXT,\n  constraints_use TEXT,\n  constraints_avoid TEXT,\n  assumptions TEXT,\n  tasks TEXT,\n  definition_of_done TEXT,\n  change_class TEXT,\n  change_class_reason TEXT,\n  plan TEXT,\n  derived_knowledge TEXT,\n  comments TEXT,\n  origin_spec_id TEXT,\n  created_at TEXT DEFAULT (datetime('now')),\n  updated_at TEXT DEFAULT (datetime('now'))\n)";
+export declare const CREATE_TICKETS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_tickets_status ON tickets(status);\nCREATE INDEX IF NOT EXISTS idx_tickets_created ON tickets(created_at)";
+export declare const CREATE_KNOWLEDGE_TABLE = "\nCREATE TABLE IF NOT EXISTS knowledge (\n  id TEXT PRIMARY KEY,\n  namespace TEXT NOT NULL DEFAULT 'global',\n  chunk_index INTEGER DEFAULT 0,\n  title TEXT NOT NULL,\n  content TEXT NOT NULL,\n  embedding F32_BLOB(384),\n  category TEXT,\n  tags TEXT,\n  source TEXT NOT NULL DEFAULT 'manual',\n  origin_ticket_id TEXT,\n  origin_ticket_type TEXT,\n  confidence REAL DEFAULT 1.0,\n  active INTEGER DEFAULT 1,\n  decision_scope TEXT NOT NULL DEFAULT 'global',\n  usage_count INTEGER DEFAULT 0,\n  last_used_at TEXT,\n  created_at TEXT DEFAULT (datetime('now')),\n  updated_at TEXT DEFAULT (datetime('now')),\n  FOREIGN KEY (origin_ticket_id) REFERENCES tickets(id)\n)";
+export declare const CREATE_KNOWLEDGE_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_knowledge_namespace ON knowledge(namespace);\nCREATE INDEX IF NOT EXISTS idx_knowledge_category ON knowledge(category);\nCREATE INDEX IF NOT EXISTS idx_knowledge_active ON knowledge(active);\nCREATE INDEX IF NOT EXISTS idx_knowledge_scope ON knowledge(decision_scope)";
+export declare const CREATE_VECTOR_INDEX = "\nCREATE INDEX IF NOT EXISTS knowledge_embedding_idx ON knowledge(libsql_vector_idx(embedding))";
+export declare const CREATE_SPECS_TABLE = "\nCREATE TABLE IF NOT EXISTS specs (\n  id TEXT PRIMARY KEY,\n  title TEXT NOT NULL,\n  content TEXT NOT NULL,\n  created_at TEXT DEFAULT (datetime('now')),\n  updated_at TEXT DEFAULT (datetime('now'))\n)";
+export declare const CREATE_SPECS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_specs_created ON specs(created_at)";

package/dist/db/schema.js

@@ -0,0 +1,64 @@
+export const CREATE_TICKETS_TABLE = `
+CREATE TABLE IF NOT EXISTS tickets (
+  id TEXT PRIMARY KEY,
+  type TEXT,
+  title TEXT,
+  status TEXT NOT NULL DEFAULT 'Backlog',
+  intent TEXT NOT NULL,
+  context TEXT,
+  constraints_use TEXT,
+  constraints_avoid TEXT,
+  assumptions TEXT,
+  tasks TEXT,
+  definition_of_done TEXT,
+  change_class TEXT,
+  change_class_reason TEXT,
+  plan TEXT,
+  derived_knowledge TEXT,
+  comments TEXT,
+  origin_spec_id TEXT,
+  created_at TEXT DEFAULT (datetime('now')),
+  updated_at TEXT DEFAULT (datetime('now'))
+)`;
+export const CREATE_TICKETS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_tickets_status ON tickets(status);
+CREATE INDEX IF NOT EXISTS idx_tickets_created ON tickets(created_at)`;
+export const CREATE_KNOWLEDGE_TABLE = `
+CREATE TABLE IF NOT EXISTS knowledge (
+  id TEXT PRIMARY KEY,
+  namespace TEXT NOT NULL DEFAULT 'global',
+  chunk_index INTEGER DEFAULT 0,
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,
+  embedding F32_BLOB(384),
+  category TEXT,
+  tags TEXT,
+  source TEXT NOT NULL DEFAULT 'manual',
+  origin_ticket_id TEXT,
+  origin_ticket_type TEXT,
+  confidence REAL DEFAULT 1.0,
+  active INTEGER DEFAULT 1,
+  decision_scope TEXT NOT NULL DEFAULT 'global',
+  usage_count INTEGER DEFAULT 0,
+  last_used_at TEXT,
+  created_at TEXT DEFAULT (datetime('now')),
+  updated_at TEXT DEFAULT (datetime('now')),
+  FOREIGN KEY (origin_ticket_id) REFERENCES tickets(id)
+)`;
+export const CREATE_KNOWLEDGE_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_knowledge_namespace ON knowledge(namespace);
+CREATE INDEX IF NOT EXISTS idx_knowledge_category ON knowledge(category);
+CREATE INDEX IF NOT EXISTS idx_knowledge_active ON knowledge(active);
+CREATE INDEX IF NOT EXISTS idx_knowledge_scope ON knowledge(decision_scope)`;
+export const CREATE_VECTOR_INDEX = `
+CREATE INDEX IF NOT EXISTS knowledge_embedding_idx ON knowledge(libsql_vector_idx(embedding))`;
+export const CREATE_SPECS_TABLE = `
+CREATE TABLE IF NOT EXISTS specs (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,
+  created_at TEXT DEFAULT (datetime('now')),
+  updated_at TEXT DEFAULT (datetime('now'))
+)`;
+export const CREATE_SPECS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_specs_created ON specs(created_at)`;

package/dist/db/usage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Knowledge usage tracking utilities.
+ */
+/**
+ * Track usage for knowledge entries by incrementing usage_count and updating last_used_at.
+ * Silently fails on error since usage tracking is non-critical.
+ */
+export declare function trackUsage(ids: string[]): Promise<void>;

package/dist/db/usage.js

@@ -0,0 +1,24 @@
+/**
+ * Knowledge usage tracking utilities.
+ */
+import { getClient } from './client.js';
+/**
+ * Track usage for knowledge entries by incrementing usage_count and updating last_used_at.
+ * Silently fails on error since usage tracking is non-critical.
+ */
+export async function trackUsage(ids) {
+    if (ids.length === 0)
+        return;
+    try {
+        const client = await getClient();
+        const now = new Date().toISOString();
+        const placeholders = ids.map(() => '?').join(',');
+        await client.execute({
+            sql: `UPDATE knowledge SET usage_count = usage_count + 1, last_used_at = ? WHERE id IN (${placeholders})`,
+            args: [now, ...ids],
+        });
+    }
+    catch {
+        // Silently fail - usage tracking is non-critical
+    }
+}

package/dist/embed/model.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate embedding for a single text.
+ * Returns a 384-dimensional normalized vector.
+ */
+export declare function embed(text: string): Promise<number[]>;

package/dist/embed/model.js

@@ -0,0 +1,34 @@
+import { pipeline, env } from '@huggingface/transformers';
+// Suppress model loading warnings
+env.allowLocalModels = true;
+env.allowRemoteModels = true;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let extractor = null;
+const MODEL_NAME = 'Xenova/all-MiniLM-L6-v2';
+/**
+ * Get or initialize the embedding pipeline.
+ * First call downloads the model (~23MB), subsequent calls use cache.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function getEmbedder() {
+    if (extractor) {
+        return extractor;
+    }
+    extractor = await pipeline('feature-extraction', MODEL_NAME, {
+        dtype: 'fp32', // Explicitly set to suppress warning
+    });
+    return extractor;
+}
+/**
+ * Generate embedding for a single text.
+ * Returns a 384-dimensional normalized vector.
+ */
+export async function embed(text) {
+    const embedder = await getEmbedder();
+    const result = await embedder(text, {
+        pooling: 'mean',
+        normalize: true,
+    });
+    // Convert Float32Array to regular array
+    return Array.from(result.data);
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { initCommand } from './commands/init.js';
+import { statusCommand } from './commands/status.js';
+import { ticketCommand } from './commands/ticket.js';
+import { extractCommand } from './commands/extract.js';
+import { searchCommand } from './commands/search.js';
+import { knowledgeCommand } from './commands/knowledge.js';
+import { uiCommand } from './commands/ui.js';
+import { specCommand } from './commands/spec.js';
+// Read version from package.json
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('superintent')
+    .description('CLI companion for the Superintent Claude Code plugin')
+    .version(packageJson.version);
+program.addCommand(initCommand);
+program.addCommand(statusCommand);
+program.addCommand(ticketCommand);
+program.addCommand(extractCommand);
+program.addCommand(searchCommand);
+program.addCommand(knowledgeCommand);
+program.addCommand(uiCommand);
+program.addCommand(specCommand);
+program.parse();

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+export interface TicketPlan {
+    files: string[];
+    taskSteps: {
+        task: string;
+        steps: string[];
+    }[];
+    dodVerification: {
+        dod: string;
+        verify: string;
+    }[];
+    decisions: {
+        choice: string;
+        reason: string;
+    }[];
+    tradeOffs: {
+        considered: string;
+        rejected: string;
+    }[];
+    rollback?: {
+        steps: string[];
+        reversibility: 'full' | 'partial' | 'none';
+    };
+    irreversibleActions: string[];
+    edgeCases: string[];
+}
+export type TicketType = 'feature' | 'bugfix' | 'refactor' | 'docs' | 'chore' | 'test';
+export interface Ticket {
+    id: string;
+    type?: TicketType;
+    title?: string;
+    status: 'Backlog' | 'In Progress' | 'In Review' | 'Done' | 'Blocked' | 'Paused' | 'Abandoned' | 'Superseded';
+    intent: string;
+    context?: string;
+    constraints_use?: string[];
+    constraints_avoid?: string[];
+    assumptions?: string[];
+    tasks?: TaskItem[];
+    definition_of_done?: TaskItem[];
+    change_class?: 'A' | 'B' | 'C';
+    change_class_reason?: string;
+    plan?: TicketPlan;
+    origin_spec_id?: string;
+    derived_knowledge?: string[];
+    comments?: TicketComment[];
+    created_at?: string;
+    updated_at?: string;
+}
+export interface TaskItem {
+    text: string;
+    done: boolean;
+}
+export interface TicketComment {
+    text: string;
+    timestamp: string;
+}
+export interface TicketInput {
+    id: string;
+    type?: TicketType;
+    title?: string;
+    intent: string;
+    context?: string;
+    constraints?: {
+        use?: string[];
+        avoid?: string[];
+    };
+    assumptions?: string[];
+    tasks?: string[] | TaskItem[];
+    definitionOfDone?: string[] | TaskItem[];
+    changeClass?: 'A' | 'B' | 'C';
+    changeClassReason?: string;
+}
+export type KnowledgeCategory = 'pattern' | 'truth' | 'principle' | 'architecture' | 'gotcha';
+export type DecisionScope = 'new-only' | 'backward-compatible' | 'global' | 'legacy-frozen';
+export type KnowledgeSource = 'ticket' | 'discovery' | 'manual';
+export interface Knowledge {
+    id: string;
+    namespace: string;
+    chunk_index: number;
+    title: string;
+    content: string;
+    category?: KnowledgeCategory;
+    tags?: string[];
+    source: KnowledgeSource;
+    origin_ticket_id?: string;
+    origin_ticket_type?: TicketType;
+    confidence: number;
+    active: boolean;
+    decision_scope: DecisionScope;
+    usage_count: number;
+    last_used_at?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface KnowledgeInput {
+    namespace?: string;
+    title: string;
+    content: string;
+    category?: KnowledgeCategory;
+    tags?: string[];
+    source?: KnowledgeSource;
+    originTicketId?: string;
+    originTicketType?: TicketType;
+    confidence?: number;
+    decisionScope?: DecisionScope;
+}
+export interface SearchResult extends Knowledge {
+    score: number;
+}
+export interface Spec {
+    id: string;
+    title: string;
+    content: string;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface CliResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/ui/components/index.d.ts

@@ -0,0 +1,6 @@
+export { escapeHtml, ColumnData, renderMarkdownEditor } from './utils.js';
+export { getHtml } from './layout.js';
+export { renderTicketCard, renderKanbanView, renderKanbanColumns, renderColumnMore, renderTicketModal, renderNewTicketModal, renderEditTicketModal, } from './ticket.js';
+export { renderKnowledgeView, renderKnowledgeList, renderKnowledgeModal, } from './knowledge.js';
+export { renderSearchView, renderSearchResults, } from './search.js';
+export { renderSpecView, renderSpecList, renderSpecCard, renderSpecModal, renderNewSpecModal, renderEditSpecModal, } from './spec.js';

package/dist/ui/components/index.js

@@ -0,0 +1,13 @@
+// Barrel export for UI components
+// Utils
+export { escapeHtml, renderMarkdownEditor } from './utils.js';
+// Layout
+export { getHtml } from './layout.js';
+// Ticket components
+export { renderTicketCard, renderKanbanView, renderKanbanColumns, renderColumnMore, renderTicketModal, renderNewTicketModal, renderEditTicketModal, } from './ticket.js';
+// Knowledge components
+export { renderKnowledgeView, renderKnowledgeList, renderKnowledgeModal, } from './knowledge.js';
+// Search components
+export { renderSearchView, renderSearchResults, } from './search.js';
+// Spec components
+export { renderSpecView, renderSpecList, renderSpecCard, renderSpecModal, renderNewSpecModal, renderEditSpecModal, } from './spec.js';

package/dist/ui/components/knowledge.d.ts

@@ -0,0 +1,33 @@
+export declare function renderKnowledgeView(): string;
+export declare function renderKnowledgeList(items: {
+    id: string;
+    title: string;
+    content: string;
+    category?: string;
+    namespace: string;
+    source?: string;
+    origin_ticket_type?: string;
+    tags?: string[];
+    confidence: number;
+    active: boolean;
+    decision_scope: string;
+    created_at?: string;
+}[]): string;
+export declare function renderKnowledgeModal(knowledge: {
+    id: string;
+    namespace: string;
+    title: string;
+    content: string;
+    category?: string;
+    tags?: string[];
+    source: string;
+    origin_ticket_id?: string;
+    origin_ticket_type?: string;
+    confidence: number;
+    active: boolean;
+    decision_scope: string;
+    usage_count?: number;
+    last_used_at?: string;
+    created_at?: string;
+    updated_at?: string;
+}): string;