@nodesify/astria 1.0.0 → 1.0.1

package/dist/commands/hook-guard.js

@@ -1,145 +1,145 @@
-"use strict";
-// hook-guard: editor PreToolUse guards (port of upstream hook-guard). Reads
-// the tool-call JSON from stdin, nudges agents toward graph queries, and —
-// in strict mode — denies ONE un-indexed read per session until the agent
-// orients via query/explain/path. Fails open on any error: a wedged guard
-// must never break a tool call.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hookGuard = hookGuard;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const SOURCE_EXTS = new Set([
-    '.py', '.ts', '.tsx', '.js', '.jsx', '.rs', '.go', '.java', '.c', '.cpp',
-    '.h', '.hpp', '.rb', '.php', '.swift', '.kt', '.scala', '.cs', '.lua',
-    '.ex', '.exs', '.hs', '.sh', '.dart', '.zig', '.md', '.toml', '.yaml', '.yml',
-]);
-const SEARCH_COMMANDS = new Set(['grep', 'rg', 'ag', 'git']);
-function readStdinJson() {
-    try {
-        const raw = (0, fs_1.readFileSync)(0, 'utf-8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-function graphDir() {
-    const cwd = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-    const g = (0, path_1.join)(cwd, '.astria');
-    return (0, fs_1.existsSync)((0, path_1.join)(g, 'graph.json')) ? g : null;
-}
-/// Reads `ASTRIA_<name>`, falling back to the deprecated `GRAPHIFY_<name>`.
-function envVar(name) {
-    return (process.env[`ASTRIA_${name}`] ||
-        process.env[`GRAPHIFY_${name}`] ||
-        undefined);
-}
-function orientedRecently(gdir) {
-    try {
-        const stamp = (0, fs_1.readFileSync)((0, path_1.join)(gdir, 'cache', 'last_query_stamp'), 'utf-8');
-        const ts = Number(stamp.split('\t')[0]);
-        const age = Date.now() / 1000 - ts;
-        const ttl = Number(envVar('HOOK_STRICT_TTL') || 1800);
-        return Number.isFinite(ts) && age < ttl;
-    }
-    catch {
-        return false;
-    }
-}
-function emitNudge(text) {
-    console.log(JSON.stringify({
-        hookSpecificOutput: {
-            hookEventName: 'PreToolUse',
-            additionalContext: text,
-        },
-    }));
-}
-function emitDeny(reason) {
-    console.log(JSON.stringify({
-        hookSpecificOutput: {
-            hookEventName: 'PreToolUse',
-            permissionDecision: 'deny',
-            permissionDecisionReason: reason,
-        },
-    }));
-}
-function hookGuard(mode, _args) {
-    try {
-        if (!mode || mode === 'gemini') {
-            // Gemini's BeforeTool only understands allow decisions.
-            console.log(JSON.stringify({ decision: 'allow' }));
-            return;
-        }
-        const input = readStdinJson();
-        if (!input)
-            return;
-        const gdir = graphDir();
-        if (!gdir)
-            return;
-        const strict = envVar('HOOK_STRICT') === '1' ||
-            (envVar('HOOK_STRICT') !== '0' && _args.includes('--strict'));
-        if (mode === 'search') {
-            const ti = input.tool_input || {};
-            const isGrepTool = Boolean(ti.pattern);
-            const cmd = (ti.command || '').trim();
-            const first = cmd.split(/\s+/)[0];
-            const isSearchBash = first === 'git'
-                ? cmd.split(/\s+/)[1] === 'grep'
-                : SEARCH_COMMANDS.has(first);
-            if (isGrepTool || isSearchBash) {
-                emitNudge('MANDATORY: Before searching with grep, check the knowledge graph first: ' +
-                    '`astria query "<question>"` returns structured answers with ' +
-                    'file:line provenance in one call. The graph is already built for this repo.');
-            }
-            return;
-        }
-        if (mode === 'read') {
-            const filePath = input.tool_input?.file_path;
-            if (!filePath)
-                return;
-            const resolved = (0, path_1.resolve)(filePath);
-            if (resolved.includes('.astria'))
-                return;
-            const ext = (0, path_1.extname)(resolved).toLowerCase();
-            if (ext && !SOURCE_EXTS.has(ext))
-                return;
-            // Staleness: file newer than the graph?
-            try {
-                const fileMtime = require('fs').statSync(resolved).mtimeMs;
-                const graphMtime = require('fs').statSync((0, path_1.join)(gdir, 'db.sqlite')).mtimeMs;
-                if (fileMtime > graphMtime) {
-                    emitNudge(`STALE GRAPH: ${filePath} changed after the last graph build. ` +
-                        'Run `astria update .` before trusting graph answers.');
-                    return;
-                }
-            }
-            catch {
-                // stat failures are not guard failures
-            }
-            // Strict: deny one un-indexed read per session until oriented.
-            if (strict && input.tool_name === 'Read' && !orientedRecently(gdir)) {
-                // Session ids become filenames; strip anything that could carry a
-                // path separator or traversal before using one.
-                const session = (process.env.CLAUDE_SESSION_ID || 'default')
-                    .replace(/[^A-Za-z0-9_-]/g, '')
-                    .slice(0, 64) || 'default';
-                const marker = (0, path_1.join)(gdir, 'cache', 'hook_sessions', `${session}.denied`);
-                try {
-                    (0, fs_1.mkdirSync)((0, path_1.join)(gdir, 'cache', 'hook_sessions'), { recursive: true });
-                    (0, fs_1.writeFileSync)(marker, String(Date.now()), { flag: 'wx' });
-                    emitDeny('ORIENT FIRST: this read is not yet covered by a graph query. ' +
-                        'Run `astria query "<question>"` (or explain/path) once — ' +
-                        'further reads then proceed without interruption for 30 minutes.');
-                }
-                catch {
-                    // Marker exists: already denied once this session — allow.
-                }
-            }
-            return;
-        }
-    }
-    catch {
-        // Fail open: never break a tool call.
-    }
-}
+"use strict";
+// hook-guard: editor PreToolUse guards (port of upstream hook-guard). Reads
+// the tool-call JSON from stdin, nudges agents toward graph queries, and —
+// in strict mode — denies ONE un-indexed read per session until the agent
+// orients via query/explain/path. Fails open on any error: a wedged guard
+// must never break a tool call.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hookGuard = hookGuard;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const SOURCE_EXTS = new Set([
+    '.py', '.ts', '.tsx', '.js', '.jsx', '.rs', '.go', '.java', '.c', '.cpp',
+    '.h', '.hpp', '.rb', '.php', '.swift', '.kt', '.scala', '.cs', '.lua',
+    '.ex', '.exs', '.hs', '.sh', '.dart', '.zig', '.md', '.toml', '.yaml', '.yml',
+]);
+const SEARCH_COMMANDS = new Set(['grep', 'rg', 'ag', 'git']);
+function readStdinJson() {
+    try {
+        const raw = (0, fs_1.readFileSync)(0, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function graphDir() {
+    const cwd = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+    const g = (0, path_1.join)(cwd, '.astria');
+    return (0, fs_1.existsSync)((0, path_1.join)(g, 'graph.json')) ? g : null;
+}
+/// Reads `ASTRIA_<name>`, falling back to the deprecated `GRAPHIFY_<name>`.
+function envVar(name) {
+    return (process.env[`ASTRIA_${name}`] ||
+        process.env[`GRAPHIFY_${name}`] ||
+        undefined);
+}
+function orientedRecently(gdir) {
+    try {
+        const stamp = (0, fs_1.readFileSync)((0, path_1.join)(gdir, 'cache', 'last_query_stamp'), 'utf-8');
+        const ts = Number(stamp.split('\t')[0]);
+        const age = Date.now() / 1000 - ts;
+        const ttl = Number(envVar('HOOK_STRICT_TTL') || 1800);
+        return Number.isFinite(ts) && age < ttl;
+    }
+    catch {
+        return false;
+    }
+}
+function emitNudge(text) {
+    console.log(JSON.stringify({
+        hookSpecificOutput: {
+            hookEventName: 'PreToolUse',
+            additionalContext: text,
+        },
+    }));
+}
+function emitDeny(reason) {
+    console.log(JSON.stringify({
+        hookSpecificOutput: {
+            hookEventName: 'PreToolUse',
+            permissionDecision: 'deny',
+            permissionDecisionReason: reason,
+        },
+    }));
+}
+function hookGuard(mode, _args) {
+    try {
+        if (!mode || mode === 'gemini') {
+            // Gemini's BeforeTool only understands allow decisions.
+            console.log(JSON.stringify({ decision: 'allow' }));
+            return;
+        }
+        const input = readStdinJson();
+        if (!input)
+            return;
+        const gdir = graphDir();
+        if (!gdir)
+            return;
+        const strict = envVar('HOOK_STRICT') === '1' ||
+            (envVar('HOOK_STRICT') !== '0' && _args.includes('--strict'));
+        if (mode === 'search') {
+            const ti = input.tool_input || {};
+            const isGrepTool = Boolean(ti.pattern);
+            const cmd = (ti.command || '').trim();
+            const first = cmd.split(/\s+/)[0];
+            const isSearchBash = first === 'git'
+                ? cmd.split(/\s+/)[1] === 'grep'
+                : SEARCH_COMMANDS.has(first);
+            if (isGrepTool || isSearchBash) {
+                emitNudge('MANDATORY: Before searching with grep, check the knowledge graph first: ' +
+                    '`astria query "<question>"` returns structured answers with ' +
+                    'file:line provenance in one call. The graph is already built for this repo.');
+            }
+            return;
+        }
+        if (mode === 'read') {
+            const filePath = input.tool_input?.file_path;
+            if (!filePath)
+                return;
+            const resolved = (0, path_1.resolve)(filePath);
+            if (resolved.includes('.astria'))
+                return;
+            const ext = (0, path_1.extname)(resolved).toLowerCase();
+            if (ext && !SOURCE_EXTS.has(ext))
+                return;
+            // Staleness: file newer than the graph?
+            try {
+                const fileMtime = require('fs').statSync(resolved).mtimeMs;
+                const graphMtime = require('fs').statSync((0, path_1.join)(gdir, 'db.sqlite')).mtimeMs;
+                if (fileMtime > graphMtime) {
+                    emitNudge(`STALE GRAPH: ${filePath} changed after the last graph build. ` +
+                        'Run `astria update .` before trusting graph answers.');
+                    return;
+                }
+            }
+            catch {
+                // stat failures are not guard failures
+            }
+            // Strict: deny one un-indexed read per session until oriented.
+            if (strict && input.tool_name === 'Read' && !orientedRecently(gdir)) {
+                // Session ids become filenames; strip anything that could carry a
+                // path separator or traversal before using one.
+                const session = (process.env.CLAUDE_SESSION_ID || 'default')
+                    .replace(/[^A-Za-z0-9_-]/g, '')
+                    .slice(0, 64) || 'default';
+                const marker = (0, path_1.join)(gdir, 'cache', 'hook_sessions', `${session}.denied`);
+                try {
+                    (0, fs_1.mkdirSync)((0, path_1.join)(gdir, 'cache', 'hook_sessions'), { recursive: true });
+                    (0, fs_1.writeFileSync)(marker, String(Date.now()), { flag: 'wx' });
+                    emitDeny('ORIENT FIRST: this read is not yet covered by a graph query. ' +
+                        'Run `astria query "<question>"` (or explain/path) once — ' +
+                        'further reads then proceed without interruption for 30 minutes.');
+                }
+                catch {
+                    // Marker exists: already denied once this session — allow.
+                }
+            }
+            return;
+        }
+    }
+    catch {
+        // Fail open: never break a tool call.
+    }
+}
 //# sourceMappingURL=hook-guard.js.map

package/dist/commands/hook.d.ts

@@ -1,3 +1,3 @@
-import { Command } from 'commander';
-export declare function registerHookCommand(program: Command): void;
+import { Command } from 'commander';
+export declare function registerHookCommand(program: Command): void;
 //# sourceMappingURL=hook.d.ts.map

package/dist/commands/hook.js

@@ -1,53 +1,53 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerHookCommand = registerHookCommand;
-const hooks_1 = require("../install/hooks");
-function registerHookCommand(program) {
-    const hook = program.command('hook').description('Manage git hooks for auto-rebuild');
-    hook
-        .command('install')
-        .description('Install post-commit and post-checkout hooks')
-        .action(() => {
-        try {
-            const results = (0, hooks_1.installGitHooks)('.');
-            for (const msg of results) {
-                console.log(msg);
-            }
-        }
-        catch (err) {
-            console.error(err.message || err);
-            process.exitCode = 1;
-        }
-    });
-    hook
-        .command('uninstall')
-        .description('Remove astria git hooks')
-        .action(() => {
-        try {
-            const results = (0, hooks_1.uninstallGitHooks)('.');
-            for (const msg of results) {
-                console.log(msg);
-            }
-        }
-        catch (err) {
-            console.error(err.message || err);
-            process.exitCode = 1;
-        }
-    });
-    hook
-        .command('status')
-        .description('Show git hook status')
-        .action(() => {
-        try {
-            const results = (0, hooks_1.statusGitHooks)('.');
-            for (const msg of results) {
-                console.log(msg);
-            }
-        }
-        catch (err) {
-            console.error(err.message || err);
-            process.exitCode = 1;
-        }
-    });
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHookCommand = registerHookCommand;
+const hooks_1 = require("../install/hooks");
+function registerHookCommand(program) {
+    const hook = program.command('hook').description('Manage git hooks for auto-rebuild');
+    hook
+        .command('install')
+        .description('Install post-commit and post-checkout hooks')
+        .action(() => {
+        try {
+            const results = (0, hooks_1.installGitHooks)('.');
+            for (const msg of results) {
+                console.log(msg);
+            }
+        }
+        catch (err) {
+            console.error(err.message || err);
+            process.exitCode = 1;
+        }
+    });
+    hook
+        .command('uninstall')
+        .description('Remove astria git hooks')
+        .action(() => {
+        try {
+            const results = (0, hooks_1.uninstallGitHooks)('.');
+            for (const msg of results) {
+                console.log(msg);
+            }
+        }
+        catch (err) {
+            console.error(err.message || err);
+            process.exitCode = 1;
+        }
+    });
+    hook
+        .command('status')
+        .description('Show git hook status')
+        .action(() => {
+        try {
+            const results = (0, hooks_1.statusGitHooks)('.');
+            for (const msg of results) {
+                console.log(msg);
+            }
+        }
+        catch (err) {
+            console.error(err.message || err);
+            process.exitCode = 1;
+        }
+    });
+}
 //# sourceMappingURL=hook.js.map

package/dist/commands/install.d.ts

@@ -1,3 +1,3 @@
-import { Command } from 'commander';
-export declare function registerInstallCommand(program: Command): void;
+import { Command } from 'commander';
+export declare function registerInstallCommand(program: Command): void;
 //# sourceMappingURL=install.d.ts.map

package/dist/commands/install.js

@@ -1,40 +1,40 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerInstallCommand = registerInstallCommand;
-const index_1 = require("../install/index");
-const platforms_1 = require("../install/platforms");
-function registerInstallCommand(program) {
-    program
-        .command('install')
-        .description('Install astria skill for an AI platform')
-        .option('--platform <name>', `Platform: ${platforms_1.PLATFORM_NAMES.join(', ')}`, 'claude')
-        .action(async (opts) => {
-        try {
-            const results = (0, index_1.installPlatform)(opts.platform, process.cwd());
-            for (const msg of results) {
-                console.log(msg);
-            }
-        }
-        catch (err) {
-            console.error(err.message || err);
-            process.exitCode = 1;
-        }
-    });
-    program
-        .command('uninstall')
-        .description('Uninstall astria skill for an AI platform')
-        .option('--platform <name>', `Platform: ${platforms_1.PLATFORM_NAMES.join(', ')}`, 'claude')
-        .action(async (opts) => {
-        try {
-            const results = (0, index_1.uninstallPlatform)(opts.platform, process.cwd());
-            for (const msg of results) {
-                console.log(msg);
-            }
-        }
-        catch (err) {
-            console.error(err.message || err);
-            process.exitCode = 1;
-        }
-    });
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInstallCommand = registerInstallCommand;
+const index_1 = require("../install/index");
+const platforms_1 = require("../install/platforms");
+function registerInstallCommand(program) {
+    program
+        .command('install')
+        .description('Install astria skill for an AI platform')
+        .option('--platform <name>', `Platform: ${platforms_1.PLATFORM_NAMES.join(', ')}`, 'claude')
+        .action(async (opts) => {
+        try {
+            const results = (0, index_1.installPlatform)(opts.platform, process.cwd());
+            for (const msg of results) {
+                console.log(msg);
+            }
+        }
+        catch (err) {
+            console.error(err.message || err);
+            process.exitCode = 1;
+        }
+    });
+    program
+        .command('uninstall')
+        .description('Uninstall astria skill for an AI platform')
+        .option('--platform <name>', `Platform: ${platforms_1.PLATFORM_NAMES.join(', ')}`, 'claude')
+        .action(async (opts) => {
+        try {
+            const results = (0, index_1.uninstallPlatform)(opts.platform, process.cwd());
+            for (const msg of results) {
+                console.log(msg);
+            }
+        }
+        catch (err) {
+            console.error(err.message || err);
+            process.exitCode = 1;
+        }
+    });
+}
 //# sourceMappingURL=install.js.map

package/dist/commands/map.d.ts

@@ -1,6 +1,6 @@
-export declare function mapCommand(opts: {
-    graph: string;
-    budget: string;
-    detail?: string;
-}): Promise<void>;
+export declare function mapCommand(opts: {
+    graph: string;
+    budget: string;
+    detail?: string;
+}): Promise<void>;
 //# sourceMappingURL=map.d.ts.map

package/dist/commands/map.js

@@ -1,16 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapCommand = mapCommand;
-const native_1 = require("../native");
-async function mapCommand(opts) {
-    try {
-        const budget = parseInt(opts.budget || '2000', 10);
-        const result = (0, native_1.repoMap)(opts.graph, budget, opts.detail);
-        console.log(result.text);
-    }
-    catch (e) {
-        console.error(`Error: ${e.message || e}`);
-        process.exitCode = 1;
-    }
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapCommand = mapCommand;
+const native_1 = require("../native");
+async function mapCommand(opts) {
+    try {
+        const budget = parseInt(opts.budget || '2000', 10);
+        const result = (0, native_1.repoMap)(opts.graph, budget, opts.detail);
+        console.log(result.text);
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
 //# sourceMappingURL=map.js.map

package/dist/commands/mcp.d.ts

@@ -1,4 +1,4 @@
-export declare function mcpCommand(opts: {
-    graph: string;
-}): Promise<void>;
+export declare function mcpCommand(opts: {
+    graph: string;
+}): Promise<void>;
 //# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.js

@@ -1,15 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mcpCommand = mcpCommand;
-const native_1 = require("../native");
-async function mcpCommand(opts) {
-    try {
-        // Blocks serving newline-delimited JSON-RPC on stdio until stdin closes
-        (0, native_1.runMcpServer)(opts.graph);
-    }
-    catch (e) {
-        console.error(`Error: ${e.message || e}`);
-        process.exitCode = 1;
-    }
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpCommand = mcpCommand;
+const native_1 = require("../native");
+async function mcpCommand(opts) {
+    try {
+        // Blocks serving newline-delimited JSON-RPC on stdio until stdin closes
+        (0, native_1.runMcpServer)(opts.graph);
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
 //# sourceMappingURL=mcp.js.map

package/dist/commands/merge.d.ts

@@ -1,2 +1,2 @@
-export declare function mergeCommand(pathA: string, pathB: string, outPath: string): Promise<void>;
+export declare function mergeCommand(pathA: string, pathB: string, outPath: string): Promise<void>;
 //# sourceMappingURL=merge.d.ts.map