@crewx/doc 0.1.9-rc.139 → 0.1.9-rc.140

package/dist/cli.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 export declare function main(inputArgs?: string[]): Promise<void>;
-//# sourceMappingURL=cli.d.ts.map
+                                 

package/dist/cli.js

@@ -1,76 +1,6 @@
 #!/usr/bin/env node
-"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.main = main;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const engine_1 = require("./src/engine");
-const indexer_1 = require("./src/indexer");
-const okf_1 = require("./src/okf");
-const knowledge_core_1 = require("@crewx/knowledge-core");
-let PKG_VERSION = 'unknown';
-try {
-    const _pkgPath = fs.existsSync(path.join(__dirname, 'package.json'))
-        ? path.join(__dirname, 'package.json')
-        : path.join(__dirname, '..', 'package.json');
-    const _pkg = JSON.parse(fs.readFileSync(_pkgPath, 'utf-8'));
-    if (_pkg?.version)
-        PKG_VERSION = String(_pkg.version);
-}
-catch { }
-async function loadTracer() {
-    try {
-        return await Promise.resolve().then(() => __importStar(require('@crewx/shared/skill-tracer')));
-    }
-    catch {
-        return null;
-    }
-}
-function showDetailedUsage() {
-    const skillMd = path.join(__dirname, '..', 'SKILL.md');
-    if (fs.existsSync(skillMd)) {
-        process.stdout.write(fs.readFileSync(skillMd, 'utf-8'));
-    }
-    else {
-        console.log('No SKILL.md found. Use --help for usage.');
-    }
-}
-function printUsage(noColor) {
-    console.log(`
-@crewx/doc@${PKG_VERSION} - Document management and knowledge tools
+"use strict";var L=exports&&exports.__createBinding||(Object.create?(function(c,e,n,s){if(s===void 0)s=n;var g=Object.getOwnPropertyDescriptor(e,n);if(!g||("get"in g?!e.__esModule:g.writable||g.configurable)){g={enumerable:true,get:function(){return e[n]}}}Object.defineProperty(c,s,g)}):(function(c,e,n,s){if(s===void 0)s=n;c[s]=e[n]}));var B=exports&&exports.__setModuleDefault||(Object.create?(function(c,e){Object.defineProperty(c,"default",{enumerable:true,value:e})}):function(c,e){c["default"]=e});var q=exports&&exports.__importStar||(function(){var c=function(e){c=Object.getOwnPropertyNames||function(n){var s=[];for(var g in n)if(Object.prototype.hasOwnProperty.call(n,g))s[s.length]=g;return s};return c(e)};return function(e){if(e&&e.__esModule)return e;var n={};if(e!=null){for(var s=c(e),g=0;g<s.length;g++)if(s[g]!=="default")L(n,e,s[g])}B(n,e);return n}})();Object.defineProperty(exports,"__esModule",{value:true});exports.main=z;const h=q(require("fs"));const x=q(require("path"));const J=require("./src/engine");const _=require("./src/indexer");const N=require("./src/okf");const W=require("@crewx/knowledge-core");let M="unknown";try{const c=h.existsSync(x.join(__dirname,"package.json"))?x.join(__dirname,"package.json"):x.join(__dirname,"..","package.json");const e=JSON.parse(h.readFileSync(c,"utf-8"));if(e?.version)M=String(e.version)}catch{}async function V(){try{return await Promise.resolve().then(()=>q(require("@crewx/shared/skill-tracer")))}catch{return null}}function G(){const c=x.join(__dirname,"..","SKILL.md");if(h.existsSync(c)){process.stdout.write(h.readFileSync(c,"utf-8"))}else{console.log("No SKILL.md found. Use --help for usage.")}}function P(c){console.log(`
+@crewx/doc@${M} - Document management and knowledge tools
 
 Usage:
   doc <command> [options]
@@ -103,444 +33,17 @@ Examples:
   doc index
 
 For detailed usage guide: doc usage
-`);
-}
-function headingIds(engine, filePath, maxDepth = 6) {
-    try {
-        const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
-        const content = fs.readFileSync(resolvedPath, 'utf-8');
-        return engine.extractHeadings(content, maxDepth).slice(0, 3).map(heading => heading.id);
-    }
-    catch {
-        return [];
-    }
-}
-function printDocActions(jsonMode, context) {
-    if (jsonMode)
-        return;
-    const block = (0, knowledge_core_1.formatActions)((0, knowledge_core_1.generateNextActions)(context));
-    if (block)
-        console.log(block);
-}
-async function main(inputArgs) {
-    const args = inputArgs ?? process.argv.slice(2);
-    const command = args[0];
-    const jsonMode = args.includes('--json');
-    const positionalArgs = args.filter(arg => arg !== '--json');
-    const forceColor = args.includes('--color');
-    const noColor = !forceColor && (args.includes('--no-color') || !process.stdout.isTTY || !!process.env.NO_COLOR);
-    const engine = new engine_1.DocEngine(noColor);
-    if (command === '--version') {
-        console.log(PKG_VERSION);
-        return;
-    }
-    if (command === 'usage') {
-        showDetailedUsage();
-        return;
-    }
-    if (!command || command === '--help' || command === '-h' || command === 'help') {
-        printUsage(noColor);
-        return;
-    }
-    const docsDir = positionalArgs[1] || 'docs';
-    if (command === 'index') {
-        const entries = (0, indexer_1.indexDocs)(docsDir);
-        const importantEntries = entries.filter(e => e.important);
-        const normalEntries = entries.filter(e => !e.important);
-        const sorted = [...importantEntries, ...normalEntries];
-        if (jsonMode) {
-            console.log(JSON.stringify({
-                success: true,
-                directory: docsDir,
-                count: sorted.length,
-                documents: sorted,
-            }, null, 2));
-            return;
-        }
-        console.log(`Indexed ${entries.length} documents from ${docsDir}/`);
-        for (const entry of sorted) {
-            const star = entry.important ? '⭐ ' : '';
-            const tags = entry.tags.length > 0 ? ` [${entry.tags.join(', ')}]` : '';
-            console.log(`  ${star}${entry.id} (${entry.category})${tags} — ${entry.summary}`);
-        }
-        const allTags = [...new Set(entries.flatMap(e => e.tags))].slice(0, 3);
-        const ctx = {
-            commandId: 'doc.index',
-            params: {},
-            resultTags: allTags,
-            resultIds: sorted.slice(0, 3).map(entry => entry.id),
-            resultCount: entries.length,
-        };
-        printDocActions(jsonMode, ctx);
-        return;
-    }
-    if (command === 'stats') {
-        const entries = (0, indexer_1.indexDocs)(docsDir);
-        const importantCount = entries.filter(e => e.important).length;
-        const categoryCounts = {};
-        for (const entry of entries) {
-            categoryCounts[entry.category] = (categoryCounts[entry.category] ?? 0) + 1;
-        }
-        const sortedCategories = Object.entries(categoryCounts).sort(([, a], [, b]) => b - a);
-        const tags = (0, indexer_1.collectTags)(entries);
-        const sortedTags = Object.entries(tags).sort(([, a], [, b]) => b - a).slice(0, 10);
-        if (jsonMode) {
-            console.log(JSON.stringify({
-                success: true,
-                directory: docsDir,
-                count: entries.length,
-                important_count: importantCount,
-                categories: Object.fromEntries(sortedCategories),
-                tags: Object.fromEntries(sortedTags),
-            }, null, 2));
-            return;
-        }
-        const importantNote = importantCount > 0 ? `, ${importantCount} ⭐ important` : '';
-        console.log(`Document Stats: ${docsDir}/ (${entries.length} docs${importantNote})`);
-        console.log('\nCategories:');
-        for (const [cat, count] of sortedCategories) {
-            console.log(`  ${cat}: ${count}`);
-        }
-        console.log('\nTags TOP 10:');
-        if (sortedTags.length === 0) {
-            console.log('  (none)');
-        }
-        else {
-            for (const [tag, count] of sortedTags) {
-                console.log(`  ${tag}: ${count}`);
-            }
-        }
-        const topTags = sortedTags.slice(0, 3).map(([t]) => t);
-        const statsCtx = {
-            commandId: 'doc.stats',
-            params: {},
-            resultTags: topTags,
-            resultCount: entries.length,
-        };
-        printDocActions(jsonMode, statsCtx);
-        return;
-    }
-    if (command === 'find') {
-        const query = positionalArgs[1];
-        if (!query) {
-            const red = noColor ? '' : '\x1b[31m';
-            const reset = noColor ? '' : '\x1b[0m';
-            console.error(`${red}Error: Query required${reset}`);
-            process.exit(1);
-        }
-        const dir = positionalArgs[2] || 'docs';
-        const entries = (0, indexer_1.indexDocs)(dir);
-        const results = (0, indexer_1.findDocs)(entries, query);
-        if (jsonMode) {
-            console.log(JSON.stringify({
-                success: true,
-                directory: dir,
-                query,
-                count: results.length,
-                results,
-            }, null, 2));
-            return;
-        }
-        if (results.length === 0) {
-            console.log('No results found.');
-        }
-        else {
-            console.log(`Found ${results.length} results:`);
-            for (const r of results) {
-                console.log(`  [${r._score}] ${r.id} — ${r.summary}`);
-            }
-        }
-        const resultTags = [...new Set(results.flatMap(r => r.tags ?? []))].slice(0, 3);
-        const resultIds = results.slice(0, 3).map(r => r.id);
-        const findCtx = {
-            commandId: 'doc.find',
-            params: { query },
-            resultTags,
-            resultIds,
-            resultCount: results.length,
-        };
-        printDocActions(jsonMode, findCtx);
-        return;
-    }
-    if (command === 'graph') {
-        const entries = (0, indexer_1.indexDocs)(docsDir);
-        const graph = (0, indexer_1.buildDocGraph)(entries);
-        if (jsonMode) {
-            console.log(JSON.stringify({
-                success: true,
-                directory: docsDir,
-                graph,
-            }, null, 2));
-            return;
-        }
-        console.log(`Graph: ${graph.stats.nodeCount} nodes, ${graph.stats.edgeCount} edges`);
-        if (graph.edges.length > 0) {
-            console.log('Edges:');
-            for (const edge of graph.edges) {
-                console.log(`  ${edge.from} ↔ ${edge.to} (${edge.type}, w=${edge.weight})`);
-            }
-        }
-        const graphTags = [...new Set(entries.flatMap(e => e.tags))].slice(0, 3);
-        const graphCtx = {
-            commandId: 'doc.graph',
-            params: {},
-            resultTags: graphTags,
-            resultCount: graph.stats.nodeCount,
-        };
-        printDocActions(jsonMode, graphCtx);
-        return;
-    }
-    if (command === 'tags') {
-        const entries = (0, indexer_1.indexDocs)(docsDir);
-        const tags = (0, indexer_1.collectTags)(entries);
-        const sorted = Object.entries(tags).sort(([, a], [, b]) => b - a);
-        console.log(`Tags (${sorted.length} unique):`);
-        for (const [tag, count] of sorted) {
-            console.log(`  ${tag}: ${count}`);
-        }
-        const topTags = sorted.slice(0, 3).map(([t]) => t);
-        const tagsCtx = {
-            commandId: 'doc.tags',
-            params: {},
-            resultTags: topTags,
-            resultCount: sorted.length,
-        };
-        printDocActions(jsonMode, tagsCtx);
-        return;
-    }
-    if (command === 'properties') {
-        const entries = (0, indexer_1.indexDocs)(docsDir);
-        const props = (0, indexer_1.collectProperties)(entries);
-        console.log('Frontmatter properties:');
-        for (const [key, values] of Object.entries(props)) {
-            console.log(`  ${key}: ${values.join(', ')}`);
-        }
-        const propTags = [...new Set(entries.flatMap(e => e.tags))].slice(0, 3);
-        const propCtx = {
-            commandId: 'doc.index',
-            params: {},
-            resultTags: propTags,
-            resultCount: entries.length,
-        };
-        printDocActions(jsonMode, propCtx);
-        return;
-    }
-    if (command === 'create') {
-        const dir = args[1];
-        const title = args[2];
-        if (!dir || !title) {
-            const red = noColor ? '' : '\x1b[31m';
-            const reset = noColor ? '' : '\x1b[0m';
-            console.error(`${red}Error: dir and title are required${reset}`);
-            console.error('Usage: doc create <dir> "<title>" [--tags=t1,t2] [--category=cat] [--author=agent] [--body="content"] [--important]');
-            process.exit(1);
-        }
-        const tagsArg = args.find(a => a.startsWith('--tags='));
-        const tags = tagsArg ? tagsArg.slice('--tags='.length).split(',').map(t => t.trim()).filter(Boolean) : [];
-        const categoryArg = args.find(a => a.startsWith('--category='));
-        const category = categoryArg ? categoryArg.slice('--category='.length) : 'general';
-        const authorArg = args.find(a => a.startsWith('--author='));
-        const author = authorArg ? authorArg.slice('--author='.length) : '';
-        const bodyArg = args.find(a => a.startsWith('--body='));
-        const body = bodyArg ? bodyArg.slice('--body='.length) : '';
-        const important = args.includes('--important');
-        const slug = title
-            .trim()
-            .replace(/[\s_]+/g, '-')
-            .toLowerCase()
-            .replace(/[^a-z0-9\uAC00-\uD7AF\u3130-\u318F-]/g, '')
-            .replace(/-+/g, '-')
-            .replace(/^-+|-+$/g, '');
-        const createFilePath = path.join(dir, `${slug}.md`);
-        if (fs.existsSync(createFilePath)) {
-            const red = noColor ? '' : '\x1b[31m';
-            const reset = noColor ? '' : '\x1b[0m';
-            console.error(`${red}Error: File already exists: ${createFilePath}${reset}`);
-            process.exit(1);
-        }
-        fs.mkdirSync(dir, { recursive: true });
-        const today = new Date().toISOString().split('T')[0];
-        const tagsYaml = tags.length > 0 ? `[${tags.join(', ')}]` : '[]';
-        const authorLine = author ? `author: ${author}\n` : '';
-        const importantLine = important ? `important: true\n` : '';
-        let content = `---\ntype: document\nsummary: ${title}\ncategory: ${category}\ntags: ${tagsYaml}\ndate: ${today}\n${authorLine}${importantLine}---\n`;
-        if (body) {
-            content += `\n${body}\n`;
-        }
-        fs.writeFileSync(createFilePath, content, 'utf-8');
-        const green = noColor ? '' : '\x1b[32m';
-        const reset2 = noColor ? '' : '\x1b[0m';
-        console.log(`${green}Created:${reset2} ${createFilePath}`);
-        const createCtx = {
-            commandId: 'doc.create',
-            params: { dir, title },
-            resultTags: tags,
-            resultCount: 1,
-        };
-        printDocActions(jsonMode, createCtx);
-        return;
-    }
-    if (command === 'okf') {
-        const subcommand = args[1];
-        const okfFile = args[2];
-        const red = noColor ? '' : '\x1b[31m';
-        const green = noColor ? '' : '\x1b[32m';
-        const yellow = noColor ? '' : '\x1b[33m';
-        const reset = noColor ? '' : '\x1b[0m';
-        if (!subcommand || !['init', 'validate', 'normalize'].includes(subcommand)) {
-            console.error(`${red}Error: okf subcommand required: init | validate | normalize${reset}`);
-            console.error('Usage: doc okf <init|validate|normalize> <file> [--type=...] [--title=...] [--tags=...] [--dry-run]');
-            process.exit(1);
-        }
-        if (!okfFile) {
-            console.error(`${red}Error: File path required${reset}`);
-            process.exit(1);
-        }
-        const typeArg = args.find(a => a.startsWith('--type='))?.slice('--type='.length);
-        const titleArg = args.find(a => a.startsWith('--title='))?.slice('--title='.length);
-        const descriptionArg = args.find(a => a.startsWith('--description='))?.slice('--description='.length);
-        const tagsArg = args.find(a => a.startsWith('--tags='))?.slice('--tags='.length);
-        const parsedTags = tagsArg ? tagsArg.split(',').map(t => t.trim()).filter(Boolean) : undefined;
-        const dryRun = args.includes('--dry-run');
-        const workspaceRoot = process.cwd();
-        const absoluteOkfFile = path.isAbsolute(okfFile) ? okfFile : path.resolve(workspaceRoot, okfFile);
-        if (subcommand === 'init') {
-            if (fs.existsSync(absoluteOkfFile)) {
-                console.error(`${red}Error: File already exists: ${okfFile}${reset}`);
-                console.error('Use "doc okf normalize" to update an existing file.');
-                process.exit(1);
-            }
-            const resolvedTitle = titleArg ?? path.basename(okfFile, path.extname(okfFile)).replace(/[-_]+/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
-            const initialBody = `\n# ${resolvedTitle}\n`;
-            const normalized = (0, okf_1.normalizeOkfDocument)(initialBody, {
-                filePath: absoluteOkfFile,
-                workspaceRoot,
-                type: typeArg,
-                title: titleArg,
-                description: descriptionArg,
-                tags: parsedTags,
-            });
-            fs.mkdirSync(path.dirname(absoluteOkfFile), { recursive: true });
-            fs.writeFileSync(absoluteOkfFile, normalized, 'utf-8');
-            console.log(`${green}Created:${reset} ${okfFile}`);
-            return;
-        }
-        if (subcommand === 'validate') {
-            if (!fs.existsSync(absoluteOkfFile)) {
-                console.error(`${red}Error: File not found: ${okfFile}${reset}`);
-                process.exit(1);
-            }
-            const content = fs.readFileSync(absoluteOkfFile, 'utf-8');
-            const issues = (0, okf_1.validateOkfDocument)(content);
-            if (issues.length === 0) {
-                console.log(`${green}OK:${reset} ${okfFile} — OKF frontmatter is valid`);
-                return;
-            }
-            const errors = issues.filter(i => i.level === 'error');
-            const warnings = issues.filter(i => i.level === 'warning');
-            for (const issue of warnings) {
-                console.log(`${yellow}WARN [${issue.field}]:${reset} ${issue.message}`);
-            }
-            for (const issue of errors) {
-                console.error(`${red}ERROR [${issue.field}]:${reset} ${issue.message}`);
-            }
-            if (errors.length > 0) {
-                process.exit(1);
-            }
-            return;
-        }
-        if (subcommand === 'normalize') {
-            let existingContent = '';
-            if (fs.existsSync(absoluteOkfFile)) {
-                existingContent = fs.readFileSync(absoluteOkfFile, 'utf-8');
-            }
-            const normalized = (0, okf_1.normalizeOkfDocument)(existingContent, {
-                filePath: absoluteOkfFile,
-                workspaceRoot,
-                type: typeArg,
-                title: titleArg,
-                description: descriptionArg,
-                tags: parsedTags,
-            });
-            if (normalized === existingContent) {
-                console.log(`${green}No changes:${reset} ${okfFile} is already normalized`);
-                return;
-            }
-            if (dryRun) {
-                console.log(`${yellow}[dry-run]${reset} Would update: ${okfFile}`);
-                process.stdout.write(normalized);
-                return;
-            }
-            fs.mkdirSync(path.dirname(absoluteOkfFile), { recursive: true });
-            fs.writeFileSync(absoluteOkfFile, normalized, 'utf-8');
-            console.log(`${green}Normalized:${reset} ${okfFile}`);
-            return;
-        }
-    }
-    const filePath = args[1];
-    if (!filePath) {
-        const red = noColor ? '' : '\x1b[31m';
-        const reset = noColor ? '' : '\x1b[0m';
-        console.error(`${red}Error: File path required${reset}`);
-        printUsage(noColor);
-        process.exit(1);
-    }
-    switch (command) {
-        case 'toc': {
-            const depthArg = args.find(a => a.startsWith('--depth='));
-            const maxDepth = depthArg ? parseInt(depthArg.split('=')[1] ?? '4', 10) : 4;
-            engine.toc(filePath, { maxDepth });
-            printDocActions(jsonMode, {
-                commandId: 'doc.toc',
-                params: { file: filePath },
-                resultIds: headingIds(engine, filePath, maxDepth),
-            });
-            break;
-        }
-        case 'section': {
-            const selector = args[2];
-            if (!selector) {
-                const red = noColor ? '' : '\x1b[31m';
-                const reset = noColor ? '' : '\x1b[0m';
-                console.error(`${red}Error: Heading selector required${reset}`);
-                process.exit(1);
-            }
-            engine.section(filePath, selector);
-            printDocActions(jsonMode, {
-                commandId: 'doc.section',
-                params: { file: filePath, heading: selector },
-            });
-            break;
-        }
-        case 'status': {
-            engine.status(filePath);
-            printDocActions(jsonMode, {
-                commandId: 'doc.toc',
-                params: { file: filePath },
-                resultIds: headingIds(engine, filePath),
-            });
-            break;
-        }
-        case 'summary': {
-            engine.summary(filePath);
-            break;
-        }
-        default: {
-            const red = noColor ? '' : '\x1b[31m';
-            const reset = noColor ? '' : '\x1b[0m';
-            console.error(`${red}Unknown command: ${command}${reset}`);
-            printUsage(noColor);
-            process.exit(1);
-        }
-    }
-}
-if (require.main === module) {
-    loadTracer().then(tracer => {
-        const opts = tracer ? { skillVersion: tracer.getOwnSkillVersion(__dirname) } : {};
-        return tracer ? tracer.run('crewx/doc', main, opts) : main();
-    }).catch((err) => {
-        console.error(`Error: ${err.message}`);
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=cli.js.map
+`)}function K(c,e,n=6){try{const s=x.isAbsolute(e)?e:x.resolve(process.cwd(),e);const g=h.readFileSync(s,"utf-8");return c.extractHeadings(g,n).slice(0,3).map(E=>E.id)}catch{return[]}}function k(c,e){if(c)return;const n=(0,W.formatActions)((0,W.generateNextActions)(e));if(n)console.log(n)}async function z(c){const e=c??process.argv.slice(2);const n=e[0];const s=e.includes("--json");const g=e.filter(t=>t!=="--json");const E=e.includes("--color");const u=!E&&(e.includes("--no-color")||!process.stdout.isTTY||!!process.env.NO_COLOR);const F=new J.DocEngine(u);if(n==="--version"){console.log(M);return}if(n==="usage"){G();return}if(!n||n==="--help"||n==="-h"||n==="help"){P(u);return}const v=g[1]||"docs";if(n==="index"){const t=(0,_.indexDocs)(v);const o=t.filter(l=>l.important);const a=t.filter(l=>!l.important);const r=[...o,...a];if(s){console.log(JSON.stringify({success:true,directory:v,count:r.length,documents:r},null,2));return}console.log(`Indexed ${t.length} documents from ${v}/`);for(const l of r){const f=l.important?"\u2B50 ":"";const w=l.tags.length>0?` [${l.tags.join(", ")}]`:"";console.log(`  ${f}${l.id} (${l.category})${w} \u2014 ${l.summary}`)}const d=[...new Set(t.flatMap(l=>l.tags))].slice(0,3);const i={commandId:"doc.index",params:{},resultTags:d,resultIds:r.slice(0,3).map(l=>l.id),resultCount:t.length};k(s,i);return}if(n==="stats"){const t=(0,_.indexDocs)(v);const o=t.filter(m=>m.important).length;const a={};for(const m of t){a[m.category]=(a[m.category]??0)+1}const r=Object.entries(a).sort(([,m],[,b])=>b-m);const d=(0,_.collectTags)(t);const i=Object.entries(d).sort(([,m],[,b])=>b-m).slice(0,10);if(s){console.log(JSON.stringify({success:true,directory:v,count:t.length,important_count:o,categories:Object.fromEntries(r),tags:Object.fromEntries(i)},null,2));return}const l=o>0?`, ${o} \u2B50 important`:"";console.log(`Document Stats: ${v}/ (${t.length} docs${l})`);console.log("\nCategories:");for(const[m,b]of r){console.log(`  ${m}: ${b}`)}console.log("\nTags TOP 10:");if(i.length===0){console.log("  (none)")}else{for(const[m,b]of i){console.log(`  ${m}: ${b}`)}}const f=i.slice(0,3).map(([m])=>m);const w={commandId:"doc.stats",params:{},resultTags:f,resultCount:t.length};k(s,w);return}if(n==="find"){const t=g[1];if(!t){const f=u?"":"\x1B[31m";const w=u?"":"\x1B[0m";console.error(`${f}Error: Query required${w}`);process.exit(1)}const o=g[2]||"docs";const a=(0,_.indexDocs)(o);const r=(0,_.findDocs)(a,t);if(s){console.log(JSON.stringify({success:true,directory:o,query:t,count:r.length,results:r},null,2));return}if(r.length===0){console.log("No results found.")}else{console.log(`Found ${r.length} results:`);for(const f of r){console.log(`  [${f._score}] ${f.id} \u2014 ${f.summary}`)}}const d=[...new Set(r.flatMap(f=>f.tags??[]))].slice(0,3);const i=r.slice(0,3).map(f=>f.id);const l={commandId:"doc.find",params:{query:t},resultTags:d,resultIds:i,resultCount:r.length};k(s,l);return}if(n==="graph"){const t=(0,_.indexDocs)(v);const o=(0,_.buildDocGraph)(t);if(s){console.log(JSON.stringify({success:true,directory:v,graph:o},null,2));return}console.log(`Graph: ${o.stats.nodeCount} nodes, ${o.stats.edgeCount} edges`);if(o.edges.length>0){console.log("Edges:");for(const d of o.edges){console.log(`  ${d.from} \u2194 ${d.to} (${d.type}, w=${d.weight})`)}}const a=[...new Set(t.flatMap(d=>d.tags))].slice(0,3);const r={commandId:"doc.graph",params:{},resultTags:a,resultCount:o.stats.nodeCount};k(s,r);return}if(n==="tags"){const t=(0,_.indexDocs)(v);const o=(0,_.collectTags)(t);const a=Object.entries(o).sort(([,i],[,l])=>l-i);console.log(`Tags (${a.length} unique):`);for(const[i,l]of a){console.log(`  ${i}: ${l}`)}const r=a.slice(0,3).map(([i])=>i);const d={commandId:"doc.tags",params:{},resultTags:r,resultCount:a.length};k(s,d);return}if(n==="properties"){const t=(0,_.indexDocs)(v);const o=(0,_.collectProperties)(t);console.log("Frontmatter properties:");for(const[d,i]of Object.entries(o)){console.log(`  ${d}: ${i.join(", ")}`)}const a=[...new Set(t.flatMap(d=>d.tags))].slice(0,3);const r={commandId:"doc.index",params:{},resultTags:a,resultCount:t.length};k(s,r);return}if(n==="create"){const t=e[1];const o=e[2];if(!t||!o){const y=u?"":"\x1B[31m";const A=u?"":"\x1B[0m";console.error(`${y}Error: dir and title are required${A}`);console.error('Usage: doc create <dir> "<title>" [--tags=t1,t2] [--category=cat] [--author=agent] [--body="content"] [--important]');process.exit(1)}const a=e.find(y=>y.startsWith("--tags="));const r=a?a.slice("--tags=".length).split(",").map(y=>y.trim()).filter(Boolean):[];const d=e.find(y=>y.startsWith("--category="));const i=d?d.slice("--category=".length):"general";const l=e.find(y=>y.startsWith("--author="));const f=l?l.slice("--author=".length):"";const w=e.find(y=>y.startsWith("--body="));const m=w?w.slice("--body=".length):"";const b=e.includes("--important");const I=o.trim().replace(/[\s_]+/g,"-").toLowerCase().replace(/[^a-z0-9\uAC00-\uD7AF\u3130-\u318F-]/g,"").replace(/-+/g,"-").replace(/^-+|-+$/g,"");const j=x.join(t,`${I}.md`);if(h.existsSync(j)){const y=u?"":"\x1B[31m";const A=u?"":"\x1B[0m";console.error(`${y}Error: File already exists: ${j}${A}`);process.exit(1)}h.mkdirSync(t,{recursive:true});const $=new Date().toISOString().split("T")[0];const p=r.length>0?`[${r.join(", ")}]`:"[]";const S=f?`author: ${f}
+`:"";const T=b?`important: true
+`:"";let D=`---
+type: document
+summary: ${o}
+category: ${i}
+tags: ${p}
+date: ${$}
+${S}${T}---
+`;if(m){D+=`
+${m}
+`}h.writeFileSync(j,D,"utf-8");const O=u?"":"\x1B[32m";const R=u?"":"\x1B[0m";console.log(`${O}Created:${R} ${j}`);const U={commandId:"doc.create",params:{dir:t,title:o},resultTags:r,resultCount:1};k(s,U);return}if(n==="okf"){const t=e[1];const o=e[2];const a=u?"":"\x1B[31m";const r=u?"":"\x1B[32m";const d=u?"":"\x1B[33m";const i=u?"":"\x1B[0m";if(!t||!["init","validate","normalize"].includes(t)){console.error(`${a}Error: okf subcommand required: init | validate | normalize${i}`);console.error("Usage: doc okf <init|validate|normalize> <file> [--type=...] [--title=...] [--tags=...] [--dry-run]");process.exit(1)}if(!o){console.error(`${a}Error: File path required${i}`);process.exit(1)}const l=e.find(p=>p.startsWith("--type="))?.slice("--type=".length);const f=e.find(p=>p.startsWith("--title="))?.slice("--title=".length);const w=e.find(p=>p.startsWith("--description="))?.slice("--description=".length);const m=e.find(p=>p.startsWith("--tags="))?.slice("--tags=".length);const b=m?m.split(",").map(p=>p.trim()).filter(Boolean):void 0;const I=e.includes("--dry-run");const j=process.cwd();const $=x.isAbsolute(o)?o:x.resolve(j,o);if(t==="init"){if(h.existsSync($)){console.error(`${a}Error: File already exists: ${o}${i}`);console.error('Use "doc okf normalize" to update an existing file.');process.exit(1)}const p=f??x.basename(o,x.extname(o)).replace(/[-_]+/g," ").replace(/\b\w/g,D=>D.toUpperCase());const S=`
+# ${p}
+`;const T=(0,N.normalizeOkfDocument)(S,{filePath:$,workspaceRoot:j,type:l,title:f,description:w,tags:b});h.mkdirSync(x.dirname($),{recursive:true});h.writeFileSync($,T,"utf-8");console.log(`${r}Created:${i} ${o}`);return}if(t==="validate"){if(!h.existsSync($)){console.error(`${a}Error: File not found: ${o}${i}`);process.exit(1)}const p=h.readFileSync($,"utf-8");const S=(0,N.validateOkfDocument)(p);if(S.length===0){console.log(`${r}OK:${i} ${o} \u2014 OKF frontmatter is valid`);return}const T=S.filter(O=>O.level==="error");const D=S.filter(O=>O.level==="warning");for(const O of D){console.log(`${d}WARN [${O.field}]:${i} ${O.message}`)}for(const O of T){console.error(`${a}ERROR [${O.field}]:${i} ${O.message}`)}if(T.length>0){process.exit(1)}return}if(t==="normalize"){let p="";if(h.existsSync($)){p=h.readFileSync($,"utf-8")}const S=(0,N.normalizeOkfDocument)(p,{filePath:$,workspaceRoot:j,type:l,title:f,description:w,tags:b});if(S===p){console.log(`${r}No changes:${i} ${o} is already normalized`);return}if(I){console.log(`${d}[dry-run]${i} Would update: ${o}`);process.stdout.write(S);return}h.mkdirSync(x.dirname($),{recursive:true});h.writeFileSync($,S,"utf-8");console.log(`${r}Normalized:${i} ${o}`);return}}const C=e[1];if(!C){const t=u?"":"\x1B[31m";const o=u?"":"\x1B[0m";console.error(`${t}Error: File path required${o}`);P(u);process.exit(1)}switch(n){case"toc":{const t=e.find(a=>a.startsWith("--depth="));const o=t?parseInt(t.split("=")[1]??"4",10):4;F.toc(C,{maxDepth:o});k(s,{commandId:"doc.toc",params:{file:C},resultIds:K(F,C,o)});break}case"section":{const t=e[2];if(!t){const o=u?"":"\x1B[31m";const a=u?"":"\x1B[0m";console.error(`${o}Error: Heading selector required${a}`);process.exit(1)}F.section(C,t);k(s,{commandId:"doc.section",params:{file:C,heading:t}});break}case"status":{F.status(C);k(s,{commandId:"doc.toc",params:{file:C},resultIds:K(F,C)});break}case"summary":{F.summary(C);break}default:{const t=u?"":"\x1B[31m";const o=u?"":"\x1B[0m";console.error(`${t}Unknown command: ${n}${o}`);P(u);process.exit(1)}}}if(require.main===module){V().then(c=>{const e=c?{skillVersion:c.getOwnSkillVersion(__dirname)}:{};return c?c.run("crewx/doc",z,e):z()}).catch(c=>{console.error(`Error: ${c.message}`);process.exit(1)})}

package/dist/src/annotation.d.ts

@@ -1,2 +1,2 @@
 export declare function buildAnnotationDigest(markdown: string): string;
-//# sourceMappingURL=annotation.d.ts.map
+                                        

package/dist/src/annotation.js

@@ -1,88 +1 @@
-"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.buildAnnotationDigest = buildAnnotationDigest;
-const yaml = __importStar(require("js-yaml"));
-function splitFrontmatter(markdown) {
-    const re = /^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)([\s\S]*)$/;
-    const match = markdown.match(re);
-    if (!match)
-        return { data: null, body: markdown };
-    try {
-        const parsed = yaml.load(match[1]);
-        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-            return { data: parsed, body: match[2] };
-        }
-    }
-    catch {
-    }
-    return { data: null, body: match[2] ?? markdown };
-}
-function isActiveHighlight(h) {
-    if (!h || typeof h !== 'object')
-        return false;
-    const hl = h;
-    const status = hl.status;
-    return status !== 'orphaned' && status !== 'deleted' && status !== 'superseded';
-}
-function buildAnnotationDigest(markdown) {
-    const { data } = splitFrontmatter(markdown);
-    if (!data)
-        return '';
-    const crewx = data['crewx'];
-    if (!crewx || typeof crewx !== 'object' || Array.isArray(crewx))
-        return '';
-    const highlights = crewx['highlights'];
-    if (!Array.isArray(highlights) || highlights.length === 0)
-        return '';
-    const active = highlights.filter(isActiveHighlight);
-    if (active.length === 0)
-        return '';
-    const lines = ['[annotation digest]'];
-    for (const hl of active) {
-        const parts = [];
-        if (hl.intent)
-            parts.push(`intent=${hl.intent}`);
-        if (hl.context?.heading)
-            parts.push(`heading="${hl.context.heading}"`);
-        const meta = parts.length > 0 ? ` (${parts.join(', ')})` : '';
-        if (hl.quote)
-            lines.push(`• quote${meta}: ${hl.quote}`);
-        if (hl.note)
-            lines.push(`  note: ${hl.note}`);
-    }
-    return lines.join('\n');
-}
-//# sourceMappingURL=annotation.js.map
+"use strict";var s=exports&&exports.__createBinding||(Object.create?(function(r,e,t,n){if(n===void 0)n=t;var i=Object.getOwnPropertyDescriptor(e,t);if(!i||("get"in i?!e.__esModule:i.writable||i.configurable)){i={enumerable:true,get:function(){return e[t]}}}Object.defineProperty(r,n,i)}):(function(r,e,t,n){if(n===void 0)n=t;r[n]=e[t]}));var f=exports&&exports.__setModuleDefault||(Object.create?(function(r,e){Object.defineProperty(r,"default",{enumerable:true,value:e})}):function(r,e){r["default"]=e});var l=exports&&exports.__importStar||(function(){var r=function(e){r=Object.getOwnPropertyNames||function(t){var n=[];for(var i in t)if(Object.prototype.hasOwnProperty.call(t,i))n[n.length]=i;return n};return r(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(e!=null){for(var n=r(e),i=0;i<n.length;i++)if(n[i]!=="default")s(t,e,n[i])}f(t,e);return t}})();Object.defineProperty(exports,"__esModule",{value:true});exports.buildAnnotationDigest=y;const h=l(require("js-yaml"));function d(r){const e=/^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)([\s\S]*)$/;const t=r.match(e);if(!t)return{data:null,body:r};try{const n=h.load(t[1]);if(n&&typeof n==="object"&&!Array.isArray(n)){return{data:n,body:t[2]}}}catch{}return{data:null,body:t[2]??r}}function g(r){if(!r||typeof r!=="object")return false;const e=r;const t=e.status;return t!=="orphaned"&&t!=="deleted"&&t!=="superseded"}function y(r){const{data:e}=d(r);if(!e)return"";const t=e["crewx"];if(!t||typeof t!=="object"||Array.isArray(t))return"";const n=t["highlights"];if(!Array.isArray(n)||n.length===0)return"";const i=n.filter(g);if(i.length===0)return"";const o=["[annotation digest]"];for(const u of i){const a=[];if(u.intent)a.push(`intent=${u.intent}`);if(u.context?.heading)a.push(`heading="${u.context.heading}"`);const c=a.length>0?` (${a.join(", ")})`:"";if(u.quote)o.push(`\u2022 quote${c}: ${u.quote}`);if(u.note)o.push(`  note: ${u.note}`)}return o.join("\n")}

package/dist/src/engine.d.ts

@@ -14,4 +14,4 @@ export declare class DocEngine {
     private readFile;
 }
 export { buildAnnotationDigest } from './annotation';
-//# sourceMappingURL=engine.d.ts.map
+