@codeledger/cowork 0.2.1

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2025 Intelligent Context AI, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Note: This license applies to the CLI wrapper, types, repository scanning,
+instrumentation, harness, and report packages (the "Plugin"). The scoring
+engine (packages/core-engine/bin/) is licensed separately under LICENSE-CORE.

package/dist/artifact-writer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Artifact writer — generates Cowork output files.
+ *
+ * Writes:
+ *   .codeledger/context-bundle.json
+ *   .codeledger/trace.json
+ *   .codeledger/excerpts/{path}.txt
+ *   .codeledger/progress-snapshot.json
+ *   .codeledger/compact-summary.md
+ */
+import type { CoworkBundle, KnowledgeWeights, KnowledgeScoredFile } from '@codeledger/types';
+/**
+ * Write all Cowork artifacts to the .codeledger/ directory.
+ */
+export declare function writeCoworkArtifacts(workspaceRoot: string, bundle: CoworkBundle, scored: KnowledgeScoredFile[], weights: KnowledgeWeights): void;
+/**
+ * Write progress snapshot artifact.
+ */
+export declare function writeProgressSnapshot(workspaceRoot: string, bundle: CoworkBundle, filesRead?: string[]): void;
+/**
+ * Write compact summary (markdown).
+ */
+export declare function writeCompactSummary(workspaceRoot: string, bundle: CoworkBundle): void;
+//# sourceMappingURL=artifact-writer.d.ts.map

package/dist/artifact-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-writer.d.ts","sourceRoot":"","sources":["../src/artifact-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,YAAY,EAGZ,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAG3B;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,mBAAmB,EAAE,EAC7B,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAuCN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,YAAY,EACpB,SAAS,GAAE,MAAM,EAAO,GACvB,IAAI,CAqBN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,YAAY,GACnB,IAAI,CAgCN"}

package/dist/artifact-writer.js

@@ -0,0 +1,107 @@
+/**
+ * Artifact writer — generates Cowork output files.
+ *
+ * Writes:
+ *   .codeledger/context-bundle.json
+ *   .codeledger/trace.json
+ *   .codeledger/excerpts/{path}.txt
+ *   .codeledger/progress-snapshot.json
+ *   .codeledger/compact-summary.md
+ */
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { extractKnowledgeExcerpt } from '@codeledger/selector';
+/**
+ * Write all Cowork artifacts to the .codeledger/ directory.
+ */
+export function writeCoworkArtifacts(workspaceRoot, bundle, scored, weights) {
+    const baseDir = join(workspaceRoot, '.codeledger');
+    ensureDir(baseDir);
+    // Write context-bundle.json
+    const bundlePath = join(baseDir, 'context-bundle.json');
+    writeFileSync(bundlePath, JSON.stringify(bundle, null, 2) + '\n');
+    // Write trace.json
+    const trace = {
+        run_id: bundle.run_id,
+        timestamp: bundle.created_at,
+        scoring_profile: 'knowledge',
+        signals: weights,
+        stop_rule: {
+            sufficiency_threshold: bundle.stop_rule.sufficiency_threshold,
+            reached_at_rank: bundle.stop_rule.terminated_at_rank,
+        },
+        ranked_top: scored.slice(0, 30).map((f) => ({
+            path: f.path,
+            score: Math.round(f.score * 1000) / 1000,
+            evidence: f.reasons,
+        })),
+    };
+    writeFileSync(join(baseDir, 'trace.json'), JSON.stringify(trace, null, 2) + '\n');
+    // Write excerpts
+    const excerptsDir = join(baseDir, 'excerpts');
+    ensureDir(excerptsDir);
+    for (const file of bundle.selected) {
+        const excerpt = extractKnowledgeExcerpt(workspaceRoot, file.path, bundle.intent.tokens);
+        const excerptPath = join(workspaceRoot, file.excerpt.ref);
+        ensureDir(dirname(excerptPath));
+        writeFileSync(excerptPath, excerpt.content);
+    }
+}
+/**
+ * Write progress snapshot artifact.
+ */
+export function writeProgressSnapshot(workspaceRoot, bundle, filesRead = []) {
+    const baseDir = join(workspaceRoot, '.codeledger');
+    ensureDir(baseDir);
+    const snapshot = {
+        run_id: bundle.run_id,
+        timestamp: new Date().toISOString(),
+        last_intent: bundle.intent.text,
+        bundle_hash: bundle.workspace.fingerprint,
+        files_read: filesRead,
+        open_threads: [],
+        next_suggested_files: bundle.selected
+            .filter((f) => !filesRead.includes(f.path))
+            .slice(0, 5)
+            .map((f) => f.path),
+    };
+    writeFileSync(join(baseDir, 'progress-snapshot.json'), JSON.stringify(snapshot, null, 2) + '\n');
+}
+/**
+ * Write compact summary (markdown).
+ */
+export function writeCompactSummary(workspaceRoot, bundle) {
+    const baseDir = join(workspaceRoot, '.codeledger');
+    ensureDir(baseDir);
+    const lines = [
+        '# Cowork Session Summary',
+        '',
+        `**Intent:** ${bundle.intent.text}`,
+        `**Mode:** ${bundle.mode}`,
+        `**Bundle:** ${bundle.selected.length} files selected from ${bundle.excluded_summary.total_seen} total`,
+        `**Stop rule:** ${bundle.stop_rule.termination_reason} at rank ${bundle.stop_rule.terminated_at_rank}`,
+        '',
+        '## Selected Files',
+        '',
+    ];
+    for (const file of bundle.selected) {
+        const reasons = file.reasons.join(', ');
+        lines.push(`- **${file.path}** (score: ${file.score}) — ${reasons}`);
+    }
+    lines.push('');
+    lines.push('## Budget Usage');
+    lines.push('');
+    lines.push(`- Files: ${bundle.selected.length} / ${bundle.budgets.max_files}`);
+    lines.push(`- Estimated tokens: ~${bundle.selected.reduce((s, f) => s + Math.ceil(f.excerpt.lines_est * 5), 0)} / ${bundle.budgets.max_tokens_est}`);
+    lines.push('');
+    lines.push('---');
+    lines.push('*Generated by CodeLedger Context Governor*');
+    lines.push('');
+    writeFileSync(join(baseDir, 'compact-summary.md'), lines.join('\n'));
+}
+function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+//# sourceMappingURL=artifact-writer.js.map

package/dist/artifact-writer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { scanWorkspace } from './workspace-scanner.js';
+export type { ScanWorkspaceOptions } from './workspace-scanner.js';
+export { writeCoworkArtifacts, writeProgressSnapshot, writeCompactSummary } from './artifact-writer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { scanWorkspace } from './workspace-scanner.js';
+export { writeCoworkArtifacts, writeProgressSnapshot, writeCompactSummary } from './artifact-writer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/workspace-scanner.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Workspace scanner for knowledge mode.
+ *
+ * Lightweight alternative to the repo scanner: no dependency graph,
+ * no git churn, no test mapping. Extracts metadata from files using
+ * only filesystem information and basic content analysis.
+ *
+ * Supported file types for content extraction: .md, .txt, .json, .yaml, .yml
+ * Unsupported types: metadata only (path, mtime, size)
+ */
+import type { WorkspaceIndex } from '@codeledger/types';
+export interface ScanWorkspaceOptions {
+    root: string;
+    excludes?: string[];
+    maxFiles?: number;
+    log?: (...args: unknown[]) => void;
+}
+/**
+ * Scan a workspace directory and build a WorkspaceIndex.
+ */
+export declare function scanWorkspace(opts: ScanWorkspaceOptions): WorkspaceIndex;
+//# sourceMappingURL=workspace-scanner.d.ts.map

package/dist/workspace-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-scanner.d.ts","sourceRoot":"","sources":["../src/workspace-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,mBAAmB,CAAC;AAmC3B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,cAAc,CA2CxE"}

package/dist/workspace-scanner.js

@@ -0,0 +1,233 @@
+/**
+ * Workspace scanner for knowledge mode.
+ *
+ * Lightweight alternative to the repo scanner: no dependency graph,
+ * no git churn, no test mapping. Extracts metadata from files using
+ * only filesystem information and basic content analysis.
+ *
+ * Supported file types for content extraction: .md, .txt, .json, .yaml, .yml
+ * Unsupported types: metadata only (path, mtime, size)
+ */
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, relative, extname } from 'node:path';
+import { createHash } from 'node:crypto';
+import { detectSelectionMode } from '@codeledger/selector';
+/** Max file size to read (10 MB) */
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+/** Max files to scan (hard cap for performance) */
+const MAX_FILES = 5000;
+/** Supported extensions for full content analysis */
+const SUPPORTED_CONTENT_EXTENSIONS = new Set(['.md', '.txt', '.json', '.yaml', '.yml']);
+/** Default exclude patterns */
+const DEFAULT_EXCLUDES = new Set([
+    'node_modules', '.git', '.svn', '.hg', 'dist', 'build', 'out',
+    '__pycache__', '.cache', '.codeledger', '.cowork', '.vscode',
+    '.idea', 'vendor', 'target', '.next', '.nuxt',
+]);
+/** Map extension to CoworkFileType */
+function classifyFileType(ext) {
+    const lower = ext.toLowerCase();
+    if (lower === '.md' || lower === '.mdx')
+        return 'markdown';
+    if (lower === '.txt' || lower === '.rst' || lower === '.adoc')
+        return 'text';
+    if (lower === '.json')
+        return 'json';
+    if (lower === '.yaml' || lower === '.yml')
+        return 'yaml';
+    // Code extensions
+    const codeExts = new Set([
+        '.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs', '.java',
+        '.kt', '.cs', '.c', '.cpp', '.h', '.rb', '.php', '.swift',
+    ]);
+    if (codeExts.has(lower))
+        return 'code';
+    return 'unknown';
+}
+/**
+ * Scan a workspace directory and build a WorkspaceIndex.
+ */
+export function scanWorkspace(opts) {
+    const { root, excludes = [], maxFiles = MAX_FILES, log = () => { }, } = opts;
+    const excludeSet = new Set([...DEFAULT_EXCLUDES, ...excludes]);
+    const files = [];
+    const rootFiles = [];
+    const allPaths = [];
+    log('  Scanning workspace...');
+    walkDir(root, root, excludeSet, files, rootFiles, maxFiles);
+    log(`    Found ${files.length} files`);
+    for (const f of files) {
+        allPaths.push(f.path);
+    }
+    // Detect mode
+    const mode = detectSelectionMode({
+        filePaths: allPaths,
+        rootFiles,
+    });
+    log(`    Detected mode: ${mode}`);
+    // Compute workspace fingerprint (hash of paths + mtimes + sizes)
+    const fingerprintData = files
+        .map((f) => `${f.path}:${f.mtime}:${f.size_bytes}`)
+        .sort()
+        .join('\n');
+    const fingerprint = `ws_${createHash('md5').update(fingerprintData).digest('hex').slice(0, 12)}`;
+    return {
+        generated_at: new Date().toISOString(),
+        root,
+        fingerprint,
+        file_count: files.length,
+        files,
+        mode,
+    };
+}
+function walkDir(root, currentDir, excludes, results, rootFiles, maxFiles) {
+    if (results.length >= maxFiles)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(currentDir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (results.length >= maxFiles)
+            return;
+        if (entry.startsWith('.') && excludes.has(entry.slice(1)))
+            continue;
+        if (excludes.has(entry))
+            continue;
+        const absPath = join(currentDir, entry);
+        let stat;
+        try {
+            stat = statSync(absPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            walkDir(root, absPath, excludes, results, rootFiles, maxFiles);
+            continue;
+        }
+        if (!stat.isFile())
+            continue;
+        const relPath = relative(root, absPath);
+        const ext = extname(relPath);
+        const fileType = classifyFileType(ext);
+        // Track root-level files for mode detection
+        if (currentDir === root) {
+            rootFiles.push(entry);
+        }
+        // Skip very large files
+        if (stat.size > MAX_FILE_SIZE)
+            continue;
+        const fileInfo = {
+            path: relPath,
+            extension: ext,
+            size_bytes: stat.size,
+            mtime: stat.mtime.toISOString(),
+            lines: 0,
+            type: fileType,
+        };
+        // Extract content for supported types
+        if (SUPPORTED_CONTENT_EXTENSIONS.has(ext.toLowerCase()) && stat.size <= MAX_FILE_SIZE) {
+            try {
+                const content = readFileSync(absPath, 'utf-8');
+                // Skip binary
+                if (content.length > 0 && content.slice(0, 8192).includes('\0'))
+                    continue;
+                const lines = content.split('\n');
+                fileInfo.lines = lines.length;
+                fileInfo.content_keywords = extractKnowledgeKeywords(content, ext);
+                // Extract markdown headers
+                if (ext.toLowerCase() === '.md' || ext.toLowerCase() === '.mdx') {
+                    fileInfo.markdown_headers = extractMarkdownHeaders(lines);
+                }
+            }
+            catch {
+                // Unreadable — keep metadata only
+            }
+        }
+        results.push(fileInfo);
+    }
+}
+/**
+ * Extract keywords from knowledge file content.
+ * Simpler than code keyword extraction: focuses on meaningful words
+ * from headers, titles, and first N lines.
+ */
+function extractKnowledgeKeywords(content, ext) {
+    const tokens = new Set();
+    const lines = content.split('\n');
+    const lower = ext.toLowerCase();
+    if (lower === '.md' || lower === '.mdx') {
+        // Extract from markdown headers and first 50 lines
+        for (let i = 0; i < Math.min(lines.length, 200); i++) {
+            const line = lines[i];
+            // Headers are high-value
+            if (line.match(/^#{1,6}\s/)) {
+                extractWords(line.replace(/^#{1,6}\s*/, ''), tokens);
+            }
+            else if (i < 50) {
+                extractWords(line, tokens);
+            }
+        }
+    }
+    else if (lower === '.json') {
+        // Extract JSON keys from first 50 lines
+        const keyRe = /["']([a-zA-Z_][a-zA-Z0-9_]*)["']\s*:/g;
+        for (let i = 0; i < Math.min(lines.length, 50); i++) {
+            let m;
+            keyRe.lastIndex = 0;
+            while ((m = keyRe.exec(lines[i])) !== null) {
+                addToken(m[1], tokens);
+            }
+        }
+    }
+    else if (lower === '.yaml' || lower === '.yml') {
+        // Extract YAML keys from first 50 lines
+        const yamlKeyRe = /^(\s*)([a-zA-Z_][a-zA-Z0-9_]*)\s*:/;
+        for (let i = 0; i < Math.min(lines.length, 50); i++) {
+            const m = yamlKeyRe.exec(lines[i]);
+            if (m) {
+                addToken(m[2], tokens);
+            }
+        }
+    }
+    else {
+        // Plain text: first 50 lines
+        for (let i = 0; i < Math.min(lines.length, 50); i++) {
+            extractWords(lines[i], tokens);
+        }
+    }
+    return [...tokens].slice(0, 50);
+}
+function extractWords(text, tokens) {
+    const words = text.toLowerCase().split(/[^\p{L}\p{N}]+/u);
+    for (const w of words) {
+        if (w.length > 2) {
+            tokens.add(w);
+        }
+    }
+}
+function addToken(name, tokens) {
+    const parts = name
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .toLowerCase()
+        .split(/[_\-]+/)
+        .filter((p) => p.length > 2);
+    for (const p of parts) {
+        tokens.add(p);
+    }
+}
+function extractMarkdownHeaders(lines) {
+    const headers = [];
+    for (const line of lines) {
+        const m = line.match(/^(#{1,6})\s+(.+)/);
+        if (m) {
+            headers.push(m[2].trim());
+        }
+    }
+    return headers;
+}
+//# sourceMappingURL=workspace-scanner.js.map

package/dist/workspace-scanner.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@codeledger/cowork",
+  "version": "0.2.1",
+  "type": "module",
+  "description": "Cowork Context Governor — deterministic context selection for Claude Cowork",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codeledgerECF/codeledger-blackbox.git",
+    "directory": "packages/cowork"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@codeledger/types": "0.2.1",
+    "@codeledger/selector": "0.2.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}