glirastes 0.1.0

package/dist/cli/commands/check-upgrade.d.ts

@@ -0,0 +1,15 @@
+import { type ChangelogEntry } from '../utils/changelog-parser.js';
+import { type Gap } from '../utils/gap-detector.js';
+export interface CheckUpgradeOptions {
+    rootDir: string;
+    fromVersion?: string;
+    cliVersion?: string;
+    log?: (message: string) => void;
+}
+export interface UpgradeAnalysis {
+    fromVersion: string;
+    toVersion: string;
+    entries: ChangelogEntry[];
+    gaps: Gap[];
+}
+export declare function checkUpgrade(options: CheckUpgradeOptions): Promise<UpgradeAnalysis>;

package/dist/cli/commands/check-upgrade.js

@@ -0,0 +1,138 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { extname, join } from 'node:path';
+import { getCliVersion } from '../utils/get-cli-version.js';
+import { getChangelogDiff } from '../utils/changelog-parser.js';
+import { detectGaps } from '../utils/gap-detector.js';
+const SCANNABLE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.json',
+]);
+const IGNORED_DIRECTORIES = new Set([
+    '.git',
+    'node_modules',
+    'dist',
+    'build',
+    'coverage',
+    '.next',
+    '.turbo',
+    '.claude',
+]);
+export async function checkUpgrade(options) {
+    const log = options.log ?? console.log;
+    const toVersion = options.cliVersion ?? getCliVersion();
+    const fromVersion = resolveFromVersion(options.rootDir, options.fromVersion);
+    const changelogPath = resolveChangelogPath(options.rootDir);
+    const changelogContent = readFileSync(changelogPath, 'utf-8');
+    const entries = getChangelogDiff(changelogContent, fromVersion, toVersion);
+    if (entries.length === 0) {
+        log(`Upgrade Analysis: v${fromVersion} -> v${toVersion}`);
+        log('No changelog entries found between these versions.');
+        if (fromVersion === toVersion) {
+            log('Tip: run with --from-version <previous-version> to analyze an older baseline.');
+        }
+        return { fromVersion, toVersion, entries, gaps: [] };
+    }
+    const codebase = readProjectCodebase(options.rootDir);
+    const gaps = detectGaps(entries, codebase);
+    printReport(log, fromVersion, toVersion, gaps);
+    return { fromVersion, toVersion, entries, gaps };
+}
+function resolveFromVersion(rootDir, explicitFromVersion) {
+    if (explicitFromVersion)
+        return explicitFromVersion;
+    const manifestPath = join(rootDir, '.claude', 'skills', '.managed.json');
+    if (!existsSync(manifestPath)) {
+        throw new Error('No .claude/skills/.managed.json found. Pass --from-version <version> to analyze upgrade gaps.');
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        throw new Error('Could not parse .claude/skills/.managed.json');
+    }
+    const previousVersion = manifest.previousVersion?.trim();
+    if (previousVersion)
+        return previousVersion;
+    const version = manifest.version?.trim();
+    if (version)
+        return version;
+    throw new Error('Managed manifest is missing a valid version field.');
+}
+function resolveChangelogPath(rootDir) {
+    const candidates = [
+        join(rootDir, 'node_modules', 'glirastes', 'CHANGELOG.md'),
+        join(rootDir, 'packages', 'cli', 'CHANGELOG.md'),
+        join(rootDir, 'CHANGELOG.md'),
+    ];
+    for (const path of candidates) {
+        if (existsSync(path))
+            return path;
+    }
+    throw new Error('Cannot find CHANGELOG.md in glirastes. Update the package first.');
+}
+function readProjectCodebase(rootDir) {
+    const chunks = [];
+    walkFiles(rootDir, (filePath) => {
+        const extension = extname(filePath).toLowerCase();
+        if (!SCANNABLE_EXTENSIONS.has(extension))
+            return;
+        try {
+            chunks.push(readFileSync(filePath, 'utf-8'));
+        }
+        catch {
+            // Best-effort scanning: unreadable files are skipped.
+        }
+    });
+    return chunks.join('\n');
+}
+function walkFiles(dir, onFile) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (IGNORED_DIRECTORIES.has(entry.name))
+                continue;
+            walkFiles(fullPath, onFile);
+            continue;
+        }
+        if (entry.isFile())
+            onFile(fullPath);
+    }
+}
+function printReport(log, fromVersion, toVersion, gaps) {
+    const missingFeatures = gaps.filter((gap) => gap.type === 'missing-feature');
+    const breakingChanges = gaps.filter((gap) => gap.type === 'breaking-change');
+    log(`Upgrade Analysis: v${fromVersion} -> v${toVersion}`);
+    log('');
+    log(`New Features (${missingFeatures.length} opportunities):`);
+    if (missingFeatures.length === 0) {
+        log('  None detected.');
+    }
+    else {
+        missingFeatures.forEach((gap, index) => {
+            log(`  [${index + 1}] ${gap.changelogItem.description}`);
+            log(`      Package: ${gap.changelogItem.package}`);
+            if (gap.suggestion)
+                log(`      Suggestion: ${gap.suggestion}`);
+        });
+    }
+    log('');
+    log(`Breaking Changes (${breakingChanges.length} affecting you):`);
+    if (breakingChanges.length === 0) {
+        log('  None detected.');
+    }
+    else {
+        breakingChanges.forEach((gap, index) => {
+            log(`  [${index + 1}] ${gap.changelogItem.description}`);
+            log(`      Package: ${gap.changelogItem.package}`);
+            if (gap.suggestion)
+                log(`      Action: ${gap.suggestion}`);
+        });
+    }
+}
+//# sourceMappingURL=check-upgrade.js.map

package/dist/cli/commands/check-upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-upgrade.js","sourceRoot":"","sources":["../../../src/cli/commands/check-upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAuB,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAY,MAAM,0BAA0B,CAAC;AAsBhE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,MAAM;IACN,cAAc;IACd,MAAM;IACN,OAAO;IACP,UAAU;IACV,OAAO;IACP,QAAQ;IACR,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,IAAI,aAAa,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7E,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAE3E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,sBAAsB,WAAW,QAAQ,SAAS,EAAE,CAAC,CAAC;QAC1D,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAC1D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,GAAG,CAAC,+EAA+E,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE3C,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe,EAAE,mBAA4B;IACvE,IAAI,mBAAmB;QAAE,OAAO,mBAAmB,CAAC;IAEpD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;IACzE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;IACJ,CAAC;IAED,IAAI,QAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IACzD,IAAI,eAAe;QAAE,OAAO,eAAe,CAAC;IAE5C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACzC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe;IAC3C,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,CAAC;QAC1D,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,CAAC;QAChD,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC;KAC9B,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO;QAEjD,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,MAA8B;IAC5D,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAClD,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAClB,GAA8B,EAC9B,WAAmB,EACnB,SAAiB,EACjB,IAAW;IAEX,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;IAC7E,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;IAE7E,GAAG,CAAC,sBAAsB,WAAW,QAAQ,SAAS,EAAE,CAAC,CAAC;IAE1D,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,iBAAiB,eAAe,CAAC,MAAM,kBAAkB,CAAC,CAAC;IAC/D,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACrC,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC;YACzD,GAAG,CAAC,kBAAkB,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACnD,IAAI,GAAG,CAAC,UAAU;gBAAE,GAAG,CAAC,qBAAqB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,qBAAqB,eAAe,CAAC,MAAM,kBAAkB,CAAC,CAAC;IACnE,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACrC,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC;YACzD,GAAG,CAAC,kBAAkB,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACnD,IAAI,GAAG,CAAC,UAAU;gBAAE,GAAG,CAAC,iBAAiB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/cli/commands/test.d.ts

@@ -0,0 +1,8 @@
+interface ScaffoldTestOptions {
+    rootDir: string;
+    outputPath?: string;
+    force?: boolean;
+    dryRun?: boolean;
+}
+export declare function scaffoldTestFile(options: ScaffoldTestOptions): Promise<void>;
+export {};

package/dist/cli/commands/test.js

@@ -0,0 +1,76 @@
+import { existsSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+const TEST_TEMPLATE = `import { createAiTestSuite } from 'glirastes/server/testing';
+import { defineModule } from 'glirastes/server';
+// Import your module definitions:
+// import { modules } from '@/lib/ai/module-definitions';
+// Import your tool registries (optional, for approval tests):
+// import { endpointToolRegistry } from '@/generated/ai-tools/endpoint.generated';
+// import { uiToolRegistry } from '@/generated/ai-tools/ui.generated';
+
+// TODO: Replace with your actual module definitions
+const modules = [
+  defineModule({
+    id: 'task_query',
+    name: 'Task Query',
+    description: 'Show, search, filter tasks',
+    tools: ['list_tasks', 'get_task_details'],
+    classification: { hint: 'Show tasks', examples: ['show my tasks'] },
+  }),
+  defineModule({
+    id: 'task_mutation',
+    name: 'Task Mutation',
+    description: 'Create, update, delete tasks',
+    tools: ['create_task', 'update_task', 'delete_task'],
+    classification: { hint: 'Create/update tasks', examples: ['create a task'] },
+  }),
+];
+
+const suite = createAiTestSuite({
+  modules,
+  // tools: { ...endpointToolRegistry, ...uiToolRegistry },
+  pipeline: {
+    guardrails: { enableInjectionDetection: true, maxInputLength: 4000 },
+    confidenceThresholds: { high: 0.85, medium: 0.65 },
+  },
+});
+
+// Smoke tests: module completeness, tool naming, no duplicates
+suite.smokeTest();
+
+// Guardrails: injection detection, length limits, sanitization
+suite.guardrailsTest();
+
+// Approval flags: mutations need approval, queries don't
+// suite.approvalTest(); // Uncomment when tool registry is imported
+
+// Routing: deterministic pipeline simulation (add your own scenarios)
+suite.routingTest([
+  { input: 'show my tasks', expectModule: 'task_query', expectTools: ['list_tasks'] },
+  { input: 'create a task', expectModule: 'task_mutation', expectTools: ['create_task'] },
+]);
+`;
+export async function scaffoldTestFile(options) {
+    const { rootDir, force, dryRun } = options;
+    // Default output path: src/__tests__/ai-behavior.test.ts
+    const outputFile = options.outputPath
+        ? resolve(rootDir, options.outputPath)
+        : join(rootDir, 'src', '__tests__', 'ai-behavior.test.ts');
+    if (dryRun) {
+        console.log(TEST_TEMPLATE);
+        return;
+    }
+    if (existsSync(outputFile) && !force) {
+        console.log(`File already exists: ${outputFile}\n` +
+            `Use --force to overwrite, or --dry-run to preview.`);
+        return;
+    }
+    // Ensure directory exists
+    const dir = outputFile.substring(0, outputFile.lastIndexOf('/'));
+    const { mkdirSync } = await import('node:fs');
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(outputFile, TEST_TEMPLATE, 'utf-8');
+    console.log(`✓ Scaffolded AI behavior test at ${outputFile}`);
+    console.log(`  Edit the file to import your actual module definitions and tool registries.`);
+}
+//# sourceMappingURL=test.js.map

package/dist/cli/commands/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../src/cli/commands/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAS1C,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDrB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA4B;IACjE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3C,yDAAyD;IACzD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU;QACnC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,CAAC,CAAC;IAE7D,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CACT,wBAAwB,UAAU,IAAI;YACpC,oDAAoD,CACvD,CAAC;QACF,OAAO;IACT,CAAC;IAED,0BAA0B;IAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9C,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,oCAAoC,UAAU,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,+EAA+E,CAAC,CAAC;AAC/F,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+export declare function runCli(args: string[]): Promise<void>;