@reqall/core 0.0.1

package/dist/classify.d.ts

@@ -0,0 +1,12 @@
+import type { WorkClassification } from './types.js';
+/**
+ * Classification prompt injected into agent context after a task completes.
+ * The agent host uses this to decide whether and how to persist the work.
+ */
+export declare const CLASSIFICATION_PROMPT = "Classify the work just completed into exactly one category:\n\n| Work type                          | kind    | status     |\n|------------------------------------|---------|------------|\n| Bug fix                            | issue   | resolved   |\n| Architectural change               | arch    | resolved   |\n| New feature request (not yet done) | todo    | open       |\n| Completed feature request          | todo    | resolved   |\n| New spec or plan                   | spec    | open       |\n| Trivial / Q&A / unclassifiable     | \u2014       | no action  |\n\nIf the work is non-trivial, save it via reqall:upsert_record with the appropriate kind, status, and a short descriptive title.\nIf the work created or modified relationships between records, also call reqall:upsert_edge.";
+/**
+ * Parse a classification response from the agent into a structured result.
+ * Returns null if the work should be skipped (trivial/Q&A).
+ */
+export declare function parseClassification(kind: string | undefined, status: string | undefined, title: string | undefined): WorkClassification | null;
+//# sourceMappingURL=classify.d.ts.map

package/dist/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../src/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,+xBAY2D,CAAC;AAE9F;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,kBAAkB,GAAG,IAAI,CAgB3B"}

package/dist/classify.js

@@ -0,0 +1,38 @@
+/**
+ * Classification prompt injected into agent context after a task completes.
+ * The agent host uses this to decide whether and how to persist the work.
+ */
+export const CLASSIFICATION_PROMPT = `Classify the work just completed into exactly one category:
+
+| Work type                          | kind    | status     |
+|------------------------------------|---------|------------|
+| Bug fix                            | issue   | resolved   |
+| Architectural change               | arch    | resolved   |
+| New feature request (not yet done) | todo    | open       |
+| Completed feature request          | todo    | resolved   |
+| New spec or plan                   | spec    | open       |
+| Trivial / Q&A / unclassifiable     | —       | no action  |
+
+If the work is non-trivial, save it via reqall:upsert_record with the appropriate kind, status, and a short descriptive title.
+If the work created or modified relationships between records, also call reqall:upsert_edge.`;
+/**
+ * Parse a classification response from the agent into a structured result.
+ * Returns null if the work should be skipped (trivial/Q&A).
+ */
+export function parseClassification(kind, status, title) {
+    if (!kind || kind === '—' || !title) {
+        return null;
+    }
+    const validKinds = ['issue', 'spec', 'arch', 'test', 'todo'];
+    const validStatuses = ['open', 'resolved', 'archived', 'active', 'inactive'];
+    if (!validKinds.includes(kind))
+        return null;
+    if (status && !validStatuses.includes(status))
+        return null;
+    return {
+        kind: kind,
+        status: (status || 'open'),
+        title,
+    };
+}
+//# sourceMappingURL=classify.js.map

package/dist/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../src/classify.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;6FAYwD,CAAC;AAE9F;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAwB,EACxB,MAA0B,EAC1B,KAAyB;IAEzB,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;IACtE,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;IAEtF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,IAAkC;QACxC,MAAM,EAAE,CAAC,MAAM,IAAI,MAAM,CAAiC;QAC1D,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+import type { ReqallConfig } from './types.js';
+/**
+ * Load Reqall configuration from environment variables.
+ *
+ * Required: REQALL_API_KEY
+ * Optional: REQALL_URL, REQALL_PROJECT_NAME, REQALL_CONTEXT_LIMIT, REQALL_RECENCY_HOURS
+ */
+export declare function loadConfig(): ReqallConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAazC"}

package/dist/config.js

@@ -0,0 +1,23 @@
+const DEFAULT_URL = 'https://reqall.net';
+const DEFAULT_CONTEXT_LIMIT = 5;
+const DEFAULT_RECENCY_HOURS = 1;
+/**
+ * Load Reqall configuration from environment variables.
+ *
+ * Required: REQALL_API_KEY
+ * Optional: REQALL_URL, REQALL_PROJECT_NAME, REQALL_CONTEXT_LIMIT, REQALL_RECENCY_HOURS
+ */
+export function loadConfig() {
+    const apiKey = process.env.REQALL_API_KEY;
+    if (!apiKey) {
+        throw new Error('REQALL_API_KEY environment variable is required');
+    }
+    return {
+        apiKey,
+        url: process.env.REQALL_URL || DEFAULT_URL,
+        projectName: process.env.REQALL_PROJECT_NAME || undefined,
+        contextLimit: parseInt(process.env.REQALL_CONTEXT_LIMIT || '', 10) || DEFAULT_CONTEXT_LIMIT,
+        recencyHours: parseInt(process.env.REQALL_RECENCY_HOURS || '', 10) || DEFAULT_RECENCY_HOURS,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,oBAAoB,CAAC;AACzC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,OAAO;QACL,MAAM;QACN,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW;QAC1C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,SAAS;QACzD,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,qBAAqB;QAC3F,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,qBAAqB;KAC5F,CAAC;AACJ,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,7 @@
+import type { Record, SearchResult } from './types.js';
+/**
+ * Format recent records and search results into context lines
+ * suitable for injection into an agent's prompt.
+ */
+export declare function formatContext(projectName: string, recentRecords: Record[], searchResults: SearchResult[]): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,YAAY,EAAE,GAC5B,MAAM,CAyBR"}

package/dist/context.js

@@ -0,0 +1,27 @@
+/**
+ * Format recent records and search results into context lines
+ * suitable for injection into an agent's prompt.
+ */
+export function formatContext(projectName, recentRecords, searchResults) {
+    const lines = [];
+    lines.push(`[reqall] Project: ${projectName}`);
+    if (recentRecords.length > 0) {
+        lines.push(`[reqall] Recently updated records:`);
+        for (const r of recentRecords) {
+            lines.push(`- [${r.kind}] ${r.title} (id=${r.id}, status=${r.status}, updated: ${r.updated_at})`);
+        }
+    }
+    if (searchResults.length > 0) {
+        lines.push(`[reqall] Relevant context from memory:`);
+        for (const r of searchResults) {
+            const proj = r.project_name ? `project: ${r.project_name}, ` : '';
+            lines.push(`- [${r.kind}] ${r.title} (${proj}status: ${r.status}, similarity: ${r.similarity.toFixed(2)})`);
+            if (r.body) {
+                const truncated = r.body.length > 200 ? r.body.slice(0, 200) + '…' : r.body;
+                lines.push(`  ${truncated}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,aAAuB,EACvB,aAA6B;IAE7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,qBAAqB,WAAW,EAAE,CAAC,CAAC;IAE/C,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,MAAM,cAAc,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,KAAK,IAAI,WAAW,CAAC,CAAC,MAAM,iBAAiB,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC5G,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBACX,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC5E,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/detect-project.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Detect the current project name using a 3-step priority:
+ * 1. REQALL_PROJECT_NAME environment variable (explicit override)
+ * 2. Git remote — `<org>/<repo>` (e.g. `fingerskier/reqall`)
+ * 3. Current working directory basename as fallback
+ */
+export declare function detectProject(cwd?: string): string;
+//# sourceMappingURL=detect-project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detect-project.d.ts","sourceRoot":"","sources":["../src/detect-project.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBlD"}

package/dist/detect-project.js

@@ -0,0 +1,32 @@
+import { execSync } from 'node:child_process';
+import { basename } from 'node:path';
+/**
+ * Detect the current project name using a 3-step priority:
+ * 1. REQALL_PROJECT_NAME environment variable (explicit override)
+ * 2. Git remote — `<org>/<repo>` (e.g. `fingerskier/reqall`)
+ * 3. Current working directory basename as fallback
+ */
+export function detectProject(cwd) {
+    // 1. Explicit env var override
+    if (process.env.REQALL_PROJECT_NAME) {
+        return process.env.REQALL_PROJECT_NAME;
+    }
+    // 2. Git remote detection
+    try {
+        const remote = execSync('git remote get-url origin', {
+            cwd: cwd || process.cwd(),
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const match = remote.match(/[:/]([^/]+\/[^/]+?)(?:\.git)?$/);
+        if (match) {
+            return match[1];
+        }
+    }
+    catch {
+        // Not a git repo or no remote — fall through
+    }
+    // 3. cwd basename fallback
+    return basename(cwd || process.cwd());
+}
+//# sourceMappingURL=detect-project.js.map

package/dist/detect-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-project.js","sourceRoot":"","sources":["../src/detect-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,+BAA+B;IAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACzC,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,2BAA2B,EAAE;YACnD,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YACzB,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC7D,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;IAED,2BAA2B;IAC3B,OAAO,QAAQ,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { loadConfig } from './config.js';
+export { detectProject } from './detect-project.js';
+export { parseClassification as classifyWork, CLASSIFICATION_PROMPT } from './classify.js';
+export { formatContext } from './context.js';
+export type { ReqallConfig, RecordKind, RecordStatus, EdgeRelationship, EntityType, Project, Record, SearchResult, Edge, WorkClassification, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,IAAI,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,OAAO,EACP,MAAM,EACN,YAAY,EACZ,IAAI,EACJ,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { loadConfig } from './config.js';
+export { detectProject } from './detect-project.js';
+export { parseClassification as classifyWork, CLASSIFICATION_PROMPT } from './classify.js';
+export { formatContext } from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,IAAI,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+/** Record kinds stored in Reqall */
+export type RecordKind = 'issue' | 'spec' | 'arch' | 'test' | 'todo';
+/** Record statuses */
+export type RecordStatus = 'open' | 'resolved' | 'archived' | 'active' | 'inactive';
+/** Edge relationship types */
+export type EdgeRelationship = 'blocks' | 'implements' | 'tests' | 'parent' | 'related';
+/** Entity types for edges */
+export type EntityType = 'records' | 'projects';
+export interface ReqallConfig {
+    apiKey: string;
+    url: string;
+    projectName?: string;
+    contextLimit: number;
+    recencyHours: number;
+}
+export interface Project {
+    id: number;
+    name: string;
+}
+export interface Record {
+    id: number;
+    project_id: number;
+    project_name?: string;
+    kind: RecordKind;
+    title: string;
+    body?: string;
+    status: RecordStatus;
+    updated_at: string;
+}
+export interface SearchResult extends Record {
+    similarity: number;
+}
+export interface Edge {
+    id: number;
+    source_id: number;
+    source_table: EntityType;
+    target_id: number;
+    target_table: EntityType;
+    relationship: EdgeRelationship;
+    updated_at: string;
+}
+export interface WorkClassification {
+    kind: RecordKind;
+    status: RecordStatus;
+    title: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErE,sBAAsB;AACtB,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEpF,8BAA8B;AAC9B,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExF,6BAA6B;AAC7B,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,UAAU,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,UAAU,CAAC;IACzB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@reqall/core",
+  "version": "0.0.1",
+  "description": "Shared plugin logic for Reqall AI agent plugins",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  }
+}

package/src/classify.ts

@@ -0,0 +1,45 @@
+import type { WorkClassification } from './types.js';
+
+/**
+ * Classification prompt injected into agent context after a task completes.
+ * The agent host uses this to decide whether and how to persist the work.
+ */
+export const CLASSIFICATION_PROMPT = `Classify the work just completed into exactly one category:
+
+| Work type                          | kind    | status     |
+|------------------------------------|---------|------------|
+| Bug fix                            | issue   | resolved   |
+| Architectural change               | arch    | resolved   |
+| New feature request (not yet done) | todo    | open       |
+| Completed feature request          | todo    | resolved   |
+| New spec or plan                   | spec    | open       |
+| Trivial / Q&A / unclassifiable     | —       | no action  |
+
+If the work is non-trivial, save it via reqall:upsert_record with the appropriate kind, status, and a short descriptive title.
+If the work created or modified relationships between records, also call reqall:upsert_edge.`;
+
+/**
+ * Parse a classification response from the agent into a structured result.
+ * Returns null if the work should be skipped (trivial/Q&A).
+ */
+export function parseClassification(
+  kind: string | undefined,
+  status: string | undefined,
+  title: string | undefined,
+): WorkClassification | null {
+  if (!kind || kind === '—' || !title) {
+    return null;
+  }
+
+  const validKinds = ['issue', 'spec', 'arch', 'test', 'todo'] as const;
+  const validStatuses = ['open', 'resolved', 'archived', 'active', 'inactive'] as const;
+
+  if (!validKinds.includes(kind as any)) return null;
+  if (status && !validStatuses.includes(status as any)) return null;
+
+  return {
+    kind: kind as WorkClassification['kind'],
+    status: (status || 'open') as WorkClassification['status'],
+    title,
+  };
+}

package/src/config.ts

@@ -0,0 +1,26 @@
+import type { ReqallConfig } from './types.js';
+
+const DEFAULT_URL = 'https://reqall.net';
+const DEFAULT_CONTEXT_LIMIT = 5;
+const DEFAULT_RECENCY_HOURS = 1;
+
+/**
+ * Load Reqall configuration from environment variables.
+ *
+ * Required: REQALL_API_KEY
+ * Optional: REQALL_URL, REQALL_PROJECT_NAME, REQALL_CONTEXT_LIMIT, REQALL_RECENCY_HOURS
+ */
+export function loadConfig(): ReqallConfig {
+  const apiKey = process.env.REQALL_API_KEY;
+  if (!apiKey) {
+    throw new Error('REQALL_API_KEY environment variable is required');
+  }
+
+  return {
+    apiKey,
+    url: process.env.REQALL_URL || DEFAULT_URL,
+    projectName: process.env.REQALL_PROJECT_NAME || undefined,
+    contextLimit: parseInt(process.env.REQALL_CONTEXT_LIMIT || '', 10) || DEFAULT_CONTEXT_LIMIT,
+    recencyHours: parseInt(process.env.REQALL_RECENCY_HOURS || '', 10) || DEFAULT_RECENCY_HOURS,
+  };
+}

package/src/context.ts

@@ -0,0 +1,36 @@
+import type { Record, SearchResult } from './types.js';
+
+/**
+ * Format recent records and search results into context lines
+ * suitable for injection into an agent's prompt.
+ */
+export function formatContext(
+  projectName: string,
+  recentRecords: Record[],
+  searchResults: SearchResult[],
+): string {
+  const lines: string[] = [];
+
+  lines.push(`[reqall] Project: ${projectName}`);
+
+  if (recentRecords.length > 0) {
+    lines.push(`[reqall] Recently updated records:`);
+    for (const r of recentRecords) {
+      lines.push(`- [${r.kind}] ${r.title} (id=${r.id}, status=${r.status}, updated: ${r.updated_at})`);
+    }
+  }
+
+  if (searchResults.length > 0) {
+    lines.push(`[reqall] Relevant context from memory:`);
+    for (const r of searchResults) {
+      const proj = r.project_name ? `project: ${r.project_name}, ` : '';
+      lines.push(`- [${r.kind}] ${r.title} (${proj}status: ${r.status}, similarity: ${r.similarity.toFixed(2)})`);
+      if (r.body) {
+        const truncated = r.body.length > 200 ? r.body.slice(0, 200) + '…' : r.body;
+        lines.push(`  ${truncated}`);
+      }
+    }
+  }
+
+  return lines.join('\n');
+}

package/src/detect-project.ts

@@ -0,0 +1,34 @@
+import { execSync } from 'node:child_process';
+import { basename } from 'node:path';
+
+/**
+ * Detect the current project name using a 3-step priority:
+ * 1. REQALL_PROJECT_NAME environment variable (explicit override)
+ * 2. Git remote — `<org>/<repo>` (e.g. `fingerskier/reqall`)
+ * 3. Current working directory basename as fallback
+ */
+export function detectProject(cwd?: string): string {
+  // 1. Explicit env var override
+  if (process.env.REQALL_PROJECT_NAME) {
+    return process.env.REQALL_PROJECT_NAME;
+  }
+
+  // 2. Git remote detection
+  try {
+    const remote = execSync('git remote get-url origin', {
+      cwd: cwd || process.cwd(),
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+
+    const match = remote.match(/[:/]([^/]+\/[^/]+?)(?:\.git)?$/);
+    if (match) {
+      return match[1];
+    }
+  } catch {
+    // Not a git repo or no remote — fall through
+  }
+
+  // 3. cwd basename fallback
+  return basename(cwd || process.cwd());
+}

package/src/index.ts

@@ -0,0 +1,16 @@
+export { loadConfig } from './config.js';
+export { detectProject } from './detect-project.js';
+export { parseClassification as classifyWork, CLASSIFICATION_PROMPT } from './classify.js';
+export { formatContext } from './context.js';
+export type {
+  ReqallConfig,
+  RecordKind,
+  RecordStatus,
+  EdgeRelationship,
+  EntityType,
+  Project,
+  Record,
+  SearchResult,
+  Edge,
+  WorkClassification,
+} from './types.js';

package/src/types.ts

@@ -0,0 +1,55 @@
+/** Record kinds stored in Reqall */
+export type RecordKind = 'issue' | 'spec' | 'arch' | 'test' | 'todo';
+
+/** Record statuses */
+export type RecordStatus = 'open' | 'resolved' | 'archived' | 'active' | 'inactive';
+
+/** Edge relationship types */
+export type EdgeRelationship = 'blocks' | 'implements' | 'tests' | 'parent' | 'related';
+
+/** Entity types for edges */
+export type EntityType = 'records' | 'projects';
+
+export interface ReqallConfig {
+  apiKey: string;
+  url: string;
+  projectName?: string;
+  contextLimit: number;
+  recencyHours: number;
+}
+
+export interface Project {
+  id: number;
+  name: string;
+}
+
+export interface Record {
+  id: number;
+  project_id: number;
+  project_name?: string;
+  kind: RecordKind;
+  title: string;
+  body?: string;
+  status: RecordStatus;
+  updated_at: string;
+}
+
+export interface SearchResult extends Record {
+  similarity: number;
+}
+
+export interface Edge {
+  id: number;
+  source_id: number;
+  source_table: EntityType;
+  target_id: number;
+  target_table: EntityType;
+  relationship: EdgeRelationship;
+  updated_at: string;
+}
+
+export interface WorkClassification {
+  kind: RecordKind;
+  status: RecordStatus;
+  title: string;
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}