@nodesify/astria 1.0.0

package/dist/install/index.js

@@ -0,0 +1,362 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installPlatform = installPlatform;
+exports.uninstallPlatform = uninstallPlatform;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const platforms_1 = require("./platforms");
+const markdown_inject_1 = require("./markdown-inject");
+const settings_inject_1 = require("./settings-inject");
+function sectionMessage(result, added, updated, unchanged) {
+    return result === 'added' ? added : result === 'updated' ? updated : unchanged;
+}
+const MCP_LABELS = {
+    zcode: { name: 'ZCode MCP server', file: '.zcode/config.json' },
+    claude: { name: 'Claude MCP server', file: '.mcp.json' },
+    cursor: { name: 'Cursor MCP server', file: '.cursor/mcp.json' },
+    gemini: { name: 'Gemini MCP server', file: '.gemini/settings.json' },
+};
+function getSkillDir() {
+    return path.resolve(__dirname, '..', '..', 'skills');
+}
+/// CLAUDE_CONFIG_DIR is read exactly once, at load, and sanitized to a
+/// normalized absolute path without traversal segments (or undefined). No
+/// other code path reads it, so env input can never reach a filesystem
+/// write unvalidated.
+const CLAUDE_CONFIG_DIR = (() => {
+    const raw = process.env.CLAUDE_CONFIG_DIR;
+    if (!raw)
+        return undefined;
+    const resolved = path.resolve(raw);
+    return raw === resolved && !raw.includes('..') && path.isAbsolute(raw)
+        ? resolved
+        : undefined;
+})();
+function copySkillFile(platform, cfg) {
+    const messages = [];
+    if (!cfg.skillFile)
+        return messages;
+    // skillDst comes from the static platform table; refuse traversal
+    // segments anyway so no runtime value can redirect the install target.
+    if (cfg.skillDst.split(/[\\/]/).includes('..')) {
+        messages.push(`Refusing unsafe skill destination: ${cfg.skillDst}`);
+        return messages;
+    }
+    const src = path.join(getSkillDir(), cfg.skillFile);
+    if (!fs.existsSync(src)) {
+        messages.push(`Skill file not found: ${src}`);
+        return messages;
+    }
+    const homeDir = os.homedir();
+    const dst = path.join(homeDir, cfg.skillDst);
+    if (platform === 'claude' && CLAUDE_CONFIG_DIR) {
+        const overrideDst = path.join(CLAUDE_CONFIG_DIR, 'skills', 'astria', 'SKILL.md');
+        copyFile(src, overrideDst);
+        messages.push(`Skill file -> ${overrideDst}`);
+        return messages;
+    }
+    copyFile(src, dst);
+    messages.push(`Skill file -> ${dst}`);
+    return messages;
+}
+function copyFile(src, dst) {
+    // Sink guard: only normalized absolute destinations without traversal
+    // segments may be written, regardless of how the caller derived them.
+    if (!path.isAbsolute(dst) || dst.split(/[\\/]/).includes('..')) {
+        return;
+    }
+    const dir = path.dirname(dst);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.copyFileSync(src, dst);
+}
+function writeInstallStamp(dir) {
+    const stampPath = path.join(dir, '.astria_version');
+    // Same guard as copyFile, applied to the exact value that is written:
+    // only a normalized absolute path without traversal segments may reach
+    // the filesystem, regardless of how the caller derived it.
+    if (!path.isAbsolute(stampPath) || stampPath.split(/[\\/]/).includes('..')) {
+        return;
+    }
+    try {
+        fs.writeFileSync(stampPath, require('../../package.json').version + '\n', 'utf-8');
+    }
+    catch { /* ignore */ }
+}
+/// Pre-1.0 installs wrote skills under `skills/graphify/`. The path carries
+/// exactly one `astria` segment (the skill dir name), so the legacy
+/// destination is derivable by swapping that segment.
+function legacySkillDst(cfg) {
+    return cfg.skillDst.replace(/([\\/])astria([\\/])/, '$1graphify$2');
+}
+/// Removes the pre-1.0 skill file (and its now-empty folder) so a stale
+/// graphify skill is never left behind after install or uninstall.
+function removeLegacySkillFile(platform, cfg) {
+    const messages = [];
+    if (!cfg.skillFile)
+        return messages;
+    const targets = [path.join(os.homedir(), legacySkillDst(cfg))];
+    if (platform === 'claude' && CLAUDE_CONFIG_DIR) {
+        targets.push(path.join(CLAUDE_CONFIG_DIR, 'skills', 'graphify', 'SKILL.md'));
+    }
+    for (const legacy of targets) {
+        const dir = path.dirname(legacy);
+        const hadDir = fs.existsSync(dir);
+        if (fs.existsSync(legacy)) {
+            try {
+                fs.unlinkSync(legacy);
+                messages.push(`Legacy skill file removed: ${legacy}`);
+            }
+            catch { /* unreadable — leave it */ }
+        }
+        if (!hadDir)
+            continue;
+        // Install stamps from both eras; a folder holding only these is removed
+        // outright so no stale skill directory lingers.
+        for (const stamp of ['.astria_version', '.graphify_version']) {
+            try {
+                fs.unlinkSync(path.join(dir, stamp));
+            }
+            catch { /* absent */ }
+        }
+        try {
+            fs.rmdirSync(dir);
+        }
+        catch { /* not empty — leave */ }
+    }
+    return messages;
+}
+function installPlatform(platform, projectDir) {
+    const messages = [];
+    if (platform === 'cursor') {
+        if ((0, settings_inject_1.injectCursorRule)(projectDir)) {
+            messages.push('Cursor rule -> .cursor/rules/astria.mdc');
+        }
+        else {
+            messages.push('Cursor rule: already installed');
+        }
+        messages.push((0, settings_inject_1.injectAgentMcp)(projectDir, 'cursor')
+            ? 'Cursor MCP server -> .cursor/mcp.json'
+            : 'Cursor MCP server: already registered');
+        return messages;
+    }
+    if (platform === 'kiro') {
+        const cfg = platforms_1.PLATFORMS.kiro;
+        messages.push(...copySkillFile('kiro', cfg));
+        messages.push(...removeLegacySkillFile('kiro', cfg));
+        if ((0, settings_inject_1.injectKiroSteering)(projectDir)) {
+            messages.push('Kiro steering -> .kiro/steering/astria.md');
+        }
+        else {
+            messages.push('Kiro steering: already installed');
+        }
+        return messages;
+    }
+    const cfg = platforms_1.PLATFORMS[platform];
+    if (!cfg) {
+        messages.push(`Unknown platform: ${platform}. Available: ${Object.keys(platforms_1.PLATFORMS).join(', ')}`);
+        return messages;
+    }
+    messages.push(...copySkillFile(platform, cfg));
+    messages.push(...removeLegacySkillFile(platform, cfg));
+    if (cfg.claudeMd) {
+        const claudeMdPath = path.join(os.homedir(), '.claude', 'CLAUDE.md');
+        const registration = (0, markdown_inject_1.injectSection)(claudeMdPath, markdown_inject_1.SKILL_REGISTRATION);
+        messages.push(sectionMessage(registration, 'User CLAUDE.md: skill registration added', 'User CLAUDE.md: skill registration updated', 'User CLAUDE.md: already registered'));
+    }
+    const projectMd = path.join(projectDir, 'CLAUDE.md');
+    if (cfg.claudeMd || cfg.agentsMd || cfg.geminiMd) {
+        if (cfg.claudeMd) {
+            const result = (0, markdown_inject_1.injectSection)(projectMd, markdown_inject_1.PROJECT_MD_SECTION);
+            messages.push(sectionMessage(result, 'Project CLAUDE.md: astria section added', 'Project CLAUDE.md: astria section updated', 'Project CLAUDE.md: astria section unchanged'));
+        }
+        if (cfg.agentsMd) {
+            const agentsMd = path.join(projectDir, 'AGENTS.md');
+            const result = (0, markdown_inject_1.injectSection)(agentsMd, markdown_inject_1.PROJECT_MD_SECTION);
+            messages.push(sectionMessage(result, 'Project AGENTS.md: astria section added', 'Project AGENTS.md: astria section updated', 'Project AGENTS.md: astria section unchanged'));
+        }
+        if (cfg.geminiMd) {
+            const geminiMd = path.join(projectDir, 'GEMINI.md');
+            const result = (0, markdown_inject_1.injectSection)(geminiMd, markdown_inject_1.PROJECT_MD_SECTION);
+            messages.push(sectionMessage(result, 'Project GEMINI.md: astria section added', 'Project GEMINI.md: astria section updated', 'Project GEMINI.md: astria section unchanged'));
+        }
+    }
+    switch (cfg.settingsHook) {
+        case 'claude':
+            if ((0, settings_inject_1.injectClaudeHook)(projectDir)) {
+                messages.push('Claude PreToolUse hook -> .claude/settings.json');
+            }
+            else {
+                messages.push('Claude PreToolUse hook: already installed');
+            }
+            break;
+        case 'codex':
+            if ((0, settings_inject_1.injectCodexHook)(projectDir)) {
+                messages.push('Codex PreToolUse hook -> .codex/hooks.json');
+            }
+            else {
+                messages.push('Codex PreToolUse hook: already installed');
+            }
+            break;
+        case 'gemini':
+            if ((0, settings_inject_1.injectGeminiHook)(projectDir)) {
+                messages.push('Gemini BeforeTool hook -> .gemini/settings.json');
+            }
+            else {
+                messages.push('Gemini BeforeTool hook: already installed');
+            }
+            break;
+        case 'opencode':
+            if ((0, settings_inject_1.injectOpenCodePlugin)(projectDir)) {
+                messages.push('OpenCode plugin -> .opencode/plugins/astria.js');
+            }
+            else {
+                messages.push('OpenCode plugin: already installed');
+            }
+            break;
+    }
+    if (cfg.mcp) {
+        const label = MCP_LABELS[cfg.mcp];
+        messages.push((0, settings_inject_1.injectAgentMcp)(projectDir, cfg.mcp)
+            ? `${label.name} -> ${label.file}`
+            : `${label.name}: already registered`);
+    }
+    return messages;
+}
+function uninstallPlatform(platform, projectDir) {
+    const messages = [];
+    if (platform === 'cursor') {
+        if ((0, settings_inject_1.removeCursorRule)(projectDir)) {
+            messages.push('Cursor rule: removed');
+        }
+        else {
+            messages.push('Cursor rule: not found');
+        }
+        messages.push((0, settings_inject_1.removeAgentMcp)(projectDir, 'cursor')
+            ? 'Cursor MCP server: removed'
+            : 'Cursor MCP server: not found');
+        return messages;
+    }
+    if (platform === 'kiro') {
+        const cfg = platforms_1.PLATFORMS.kiro;
+        if (cfg.skillFile) {
+            const homeDir = os.homedir();
+            const dst = path.join(homeDir, cfg.skillDst);
+            try {
+                fs.unlinkSync(dst);
+                messages.push(`Skill file removed: ${dst}`);
+            }
+            catch {
+                messages.push('Skill file: not found');
+            }
+        }
+        messages.push(...removeLegacySkillFile('kiro', cfg));
+        if ((0, settings_inject_1.removeKiroSteering)(projectDir)) {
+            messages.push('Kiro steering: removed');
+        }
+        else {
+            messages.push('Kiro steering: not found');
+        }
+        return messages;
+    }
+    const cfg = platforms_1.PLATFORMS[platform];
+    if (!cfg) {
+        messages.push(`Unknown platform: ${platform}`);
+        return messages;
+    }
+    if (cfg.skillFile) {
+        const homeDir = os.homedir();
+        let dst = path.join(homeDir, cfg.skillDst);
+        if (platform === 'claude') {
+            const configDir = process.env.CLAUDE_CONFIG_DIR;
+            if (configDir)
+                dst = path.join(configDir, 'skills', 'astria', 'SKILL.md');
+        }
+        try {
+            fs.unlinkSync(dst);
+            messages.push(`Skill file removed: ${dst}`);
+        }
+        catch {
+            messages.push('Skill file: not found');
+        }
+    }
+    messages.push(...removeLegacySkillFile(platform, cfg));
+    if (cfg.claudeMd) {
+        const claudeMdPath = path.join(os.homedir(), '.claude', 'CLAUDE.md');
+        (0, markdown_inject_1.removeSection)(claudeMdPath);
+        messages.push('User CLAUDE.md: astria section removed');
+    }
+    if (cfg.claudeMd) {
+        (0, markdown_inject_1.removeSection)(path.join(projectDir, 'CLAUDE.md'));
+        messages.push('Project CLAUDE.md: astria section removed');
+    }
+    if (cfg.agentsMd) {
+        (0, markdown_inject_1.removeSection)(path.join(projectDir, 'AGENTS.md'));
+        messages.push('Project AGENTS.md: astria section removed');
+    }
+    if (cfg.geminiMd) {
+        (0, markdown_inject_1.removeSection)(path.join(projectDir, 'GEMINI.md'));
+        messages.push('Project GEMINI.md: astria section removed');
+    }
+    switch (cfg.settingsHook) {
+        case 'claude':
+            (0, settings_inject_1.removeClaudeHook)(projectDir);
+            messages.push('Claude PreToolUse hook: removed');
+            break;
+        case 'codex':
+            (0, settings_inject_1.removeCodexHook)(projectDir);
+            messages.push('Codex PreToolUse hook: removed');
+            break;
+        case 'gemini':
+            (0, settings_inject_1.removeGeminiHook)(projectDir);
+            messages.push('Gemini BeforeTool hook: removed');
+            break;
+        case 'opencode':
+            (0, settings_inject_1.removeOpenCodePlugin)(projectDir);
+            messages.push('OpenCode plugin: removed');
+            break;
+    }
+    if (cfg.mcp) {
+        const label = MCP_LABELS[cfg.mcp];
+        messages.push((0, settings_inject_1.removeAgentMcp)(projectDir, cfg.mcp)
+            ? `${label.name}: removed`
+            : `${label.name}: not found`);
+    }
+    return messages;
+}
+//# sourceMappingURL=index.js.map

package/dist/install/index.js.map

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

package/dist/install/markdown-inject.d.ts

@@ -0,0 +1,7 @@
+export type SectionResult = 'added' | 'updated' | 'unchanged';
+export declare const SECTION_MARKER = "<!-- astria:managed -->";
+export declare function injectSection(filePath: string, content: string): SectionResult;
+export declare function removeSection(filePath: string): boolean;
+export declare const PROJECT_MD_SECTION = "## astria\n\nThis project has an astria knowledge graph at .astria/.\nAccess it through whichever path your agent has:\n- MCP (when an astria MCP server is connected): repo_map, query_graph, explain,\n  get_neighbors, shortest_path, affected.\n- CLI (works everywhere): astria map, query, explain, path, affected.\n\nAlways-on behaviors:\n1. Prefer the graph over repeated text searches for architecture questions, feature\n   location, cross-file logic flow, and change impact; orient with repo_map (or map,\n   or .astria/graph_report.md), and run affected <node> before changing a shared symbol.\n2. Before running grep/ripgrep to locate code, try astria query first --\n   it answers with file:line provenance in one call against the already-built graph.\n3. After modifying code, run astria update . (AST-only, no API cost) so the\n   graph stays fresh; queries then report accurate staleness metadata.";
+export declare const SKILL_REGISTRATION = "\n# astria\n- **astria** (`~/.claude/skills/astria/SKILL.md`) - any input to knowledge graph. Trigger: `/astria`\nWhen the user types `/astria`, invoke the Skill tool with `skill: \"astria\"` before doing anything else.\n";
+//# sourceMappingURL=markdown-inject.d.ts.map

package/dist/install/markdown-inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-inject.d.ts","sourceRoot":"","sources":["../../src/install/markdown-inject.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAQ9D,eAAO,MAAM,cAAc,4BAA4B,CAAC;AA8DxD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAwC9E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAqBvD;AAED,eAAO,MAAM,kBAAkB,g5BAewC,CAAC;AAExE,eAAO,MAAM,kBAAkB,kOAI9B,CAAC"}

package/dist/install/markdown-inject.js

@@ -0,0 +1,178 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_REGISTRATION = exports.PROJECT_MD_SECTION = exports.SECTION_MARKER = void 0;
+exports.injectSection = injectSection;
+exports.removeSection = removeSection;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// Managed sections carry this marker so later installs can refresh them
+// wholesale. Sections are recognized two ways: by this marker, or by a
+// legacy fingerprint. Pre-1.0 installs wrote `## graphify` sections under
+// the old `nodesify-graphify:managed` marker — install upgrades them in
+// place and uninstall removes them. Anything else containing a heading is
+// treated as user-owned and left untouched.
+exports.SECTION_MARKER = '<!-- astria:managed -->';
+// Section written by this version of the CLI.
+const HEADERS = ['## astria', '# astria'];
+// Sections written by pre-1.0 nodesify-graphify installs.
+const LEGACY_HEADERS = ['## graphify', '# graphify'];
+const LEGACY_SECTION_MARKER = '<!-- nodesify-graphify:managed -->';
+const LEGACY_SECTION_SNIPPETS = [
+    // Current managed sections carry the old marker only; these fingerprints
+    // catch unmarked generated sections from earlier eras.
+    // "optional ... opt-in" wording (0.7.x-era)
+    'optional nodesify-graphify knowledge graph',
+    'maintained automatically after edits when the platform supports PostToolUse hooks',
+    // "MUST read" rules wording (early releases)
+    'MUST read .graphify/graph_report.md before searching files',
+    // "CRITICAL RULES / FORBIDDEN" wording
+    '**FORBIDDEN** from using native search tools',
+];
+function headingLevel(header) {
+    return (header.match(/^#+/) || ['#'])[0].length;
+}
+// Locate a section headed by `header` (matched at line start) and bounded
+// by the next heading at the same or higher level, or EOF.
+function findSection(existing, header) {
+    let start = existing.indexOf('\n' + header);
+    if (start === -1) {
+        if (!existing.startsWith(header))
+            return null;
+        start = 0;
+    }
+    const level = headingLevel(header);
+    const boundary = new RegExp(`\\n#{1,${level}} `);
+    const match = existing.slice(start + 1).match(boundary);
+    const end = match?.index !== undefined ? start + 1 + match.index : existing.length;
+    return { start, end };
+}
+function stripMarker(sectionText) {
+    return sectionText
+        .split('\n')
+        .filter((line) => {
+        const t = line.trim();
+        return t !== exports.SECTION_MARKER && t !== LEGACY_SECTION_MARKER;
+    })
+        .join('\n')
+        .trim();
+}
+function isManaged(sectionText) {
+    return (sectionText.includes(exports.SECTION_MARKER) ||
+        sectionText.includes(LEGACY_SECTION_MARKER) ||
+        LEGACY_SECTION_SNIPPETS.some((snippet) => sectionText.includes(snippet)));
+}
+function withMarker(content) {
+    return content.trimEnd() + '\n' + exports.SECTION_MARKER;
+}
+function injectSection(filePath, content) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf-8') : '';
+    // Refresh an existing astria section in place.
+    for (const h of HEADERS) {
+        const bounds = findSection(existing, h);
+        if (!bounds)
+            continue;
+        const sectionText = existing.slice(bounds.start, bounds.end);
+        if (stripMarker(sectionText) === content.trim())
+            return 'unchanged';
+        if (!isManaged(sectionText))
+            return 'unchanged';
+        fs.writeFileSync(filePath, existing.slice(0, bounds.start) + withMarker(content) + existing.slice(bounds.end), 'utf-8');
+        return 'updated';
+    }
+    // Upgrade a managed pre-1.0 graphify section to the astria wording. A
+    // user-customized graphify section is left untouched (treated as owned).
+    for (const h of LEGACY_HEADERS) {
+        const bounds = findSection(existing, h);
+        if (!bounds)
+            continue;
+        const sectionText = existing.slice(bounds.start, bounds.end);
+        if (!isManaged(sectionText))
+            return 'unchanged';
+        fs.writeFileSync(filePath, existing.slice(0, bounds.start) + withMarker(content) + existing.slice(bounds.end), 'utf-8');
+        return 'updated';
+    }
+    fs.writeFileSync(filePath, existing.replace(/\n*$/, '\n\n') + withMarker(content) + '\n', 'utf-8');
+    return 'added';
+}
+function removeSection(filePath) {
+    if (!fs.existsSync(filePath))
+        return false;
+    let content = fs.readFileSync(filePath, 'utf-8');
+    let changed = false;
+    for (const header of [...HEADERS, ...LEGACY_HEADERS]) {
+        let bounds = findSection(content, header);
+        while (bounds) {
+            content = content.slice(0, bounds.start) + content.slice(bounds.end);
+            changed = true;
+            bounds = findSection(content, header);
+        }
+    }
+    if (!changed)
+        return false;
+    if (content.trim().length === 0) {
+        fs.unlinkSync(filePath);
+    }
+    else {
+        fs.writeFileSync(filePath, content, 'utf-8');
+    }
+    return true;
+}
+exports.PROJECT_MD_SECTION = `## astria
+
+This project has an astria knowledge graph at .astria/.
+Access it through whichever path your agent has:
+- MCP (when an astria MCP server is connected): repo_map, query_graph, explain,
+  get_neighbors, shortest_path, affected.
+- CLI (works everywhere): astria map, query, explain, path, affected.
+
+Always-on behaviors:
+1. Prefer the graph over repeated text searches for architecture questions, feature
+   location, cross-file logic flow, and change impact; orient with repo_map (or map,
+   or .astria/graph_report.md), and run affected <node> before changing a shared symbol.
+2. Before running grep/ripgrep to locate code, try astria query first --
+   it answers with file:line provenance in one call against the already-built graph.
+3. After modifying code, run astria update . (AST-only, no API cost) so the
+   graph stays fresh; queries then report accurate staleness metadata.`;
+exports.SKILL_REGISTRATION = `
+# astria
+- **astria** (\`~/.claude/skills/astria/SKILL.md\`) - any input to knowledge graph. Trigger: \`/astria\`
+When the user types \`/astria\`, invoke the Skill tool with \`skill: "astria"\` before doing anything else.
+`;
+//# sourceMappingURL=markdown-inject.js.map

package/dist/install/markdown-inject.js.map

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

package/dist/install/platforms.d.ts

@@ -0,0 +1,13 @@
+export interface PlatformConfig {
+    skillFile: string;
+    skillDst: string;
+    claudeMd: boolean;
+    agentsMd: boolean;
+    geminiMd: boolean;
+    settingsHook: 'claude' | 'codex' | 'gemini' | 'opencode' | 'none';
+    /** Register the astria MCP server in this platform's project-scoped config. */
+    mcp?: 'zcode' | 'claude' | 'cursor' | 'gemini';
+}
+export declare const PLATFORMS: Record<string, PlatformConfig>;
+export declare const PLATFORM_NAMES: string[];
+//# sourceMappingURL=platforms.d.ts.map

package/dist/install/platforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.d.ts","sourceRoot":"","sources":["../../src/install/platforms.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAClE,+EAA+E;IAC/E,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAChD;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAyFpD,CAAC;AAEF,eAAO,MAAM,cAAc,UAAyB,CAAC"}