baselane 0.1.2 → 0.1.3

package/dist/audit.d.ts

@@ -4,5 +4,7 @@ export interface AuditResult {
     packs: string[];
     recommended: string;
 }
-export declare function auditRepo(dir: string): Promise<AuditResult>;
+export declare function auditRepo(dir: string, opts?: {
+    excludes?: string[];
+}): Promise<AuditResult>;
 export declare function formatAuditReport(r: AuditResult): string;

package/dist/audit.js

@@ -1,7 +1,7 @@
 import { analyze, LocalDirFileSource } from "@baselane/analyze";
 import { listBuiltinPacks } from "@baselane/packs";
-export async function auditRepo(dir) {
-    const profile = await analyze(new LocalDirFileSource(dir));
+export async function auditRepo(dir, opts = {}) {
+    const profile = await analyze(new LocalDirFileSource(dir, { excludes: opts.excludes }));
     const packs = await listBuiltinPacks();
     // Flagship default; every pack remains selectable via `apply --pack`.
     const recommended = "software-engineer-harness";

package/dist/cli.js

@@ -16,12 +16,12 @@ import { LocalDirFileSource, analyze, analyzeConventions, analyzeDesignTokens, n
 // page can never drift into a syntax this CLI doesn't actually accept.
 export const USAGE = [
     "usage:",
-    "  baselane audit <dir> [--json]",
+    "  baselane audit <dir> [--json] [--exclude <patterns>]",
     "  baselane apply <dir> (--pack <id> | --pack-file <path>) [--force] [--dry-run]",
     "  baselane distribute <owner/repo> (--pack <id> | --pack-file <path>) [--portal <url>]",
     "  baselane draft-pack <dir> [--json]",
-    "  baselane graph <dir> [--json]",
-    "  baselane map <dir> [--json] [--llm] [--dry-run]",
+    "  baselane graph <dir> [--json] [--exclude <patterns>]",
+    "  baselane map <dir> [--json] [--llm] [--dry-run] [--exclude <patterns>]",
     "  baselane install [github:owner/repo@ref | @scope/name[@version] | owner/repo@skill] [-g] [--dir <d>] [--dry-run] [--json]",
     "  baselane update [github:owner/repo | @scope/name] [-g] [--dir <d>] [--dry-run]",
     "  baselane drift [-g] [--dir <d>] [--json]",
@@ -31,6 +31,14 @@ function argValue(argv, flag) {
     const i = argv.indexOf(flag);
     return i !== -1 ? argv[i + 1] : undefined;
 }
+/** `--exclude a,b` → ["a", "b"] (gitignore syntax, comma-separated), or undefined when absent. */
+function excludesArg(argv) {
+    const raw = argValue(argv, "--exclude");
+    if (!raw)
+        return undefined;
+    const patterns = raw.split(",").map((p) => p.trim()).filter((p) => p !== "");
+    return patterns.length > 0 ? patterns : undefined;
+}
 // #6: --pack-file is the escape hatch for a custom pack the CLI doesn't ship (a portal-authored
 // or AI-drafted one saved to disk) — loadBuiltinPack only ever knows built-in ids. Same rule as
 // every other pack entry point in this repo: validatePack is the sole authority, so a hand-edited
@@ -53,7 +61,7 @@ export async function main(argv, deps = {}) {
     }
     try {
         if (cmd === "audit" && dir) {
-            const result = await auditRepo(dir);
+            const result = await auditRepo(dir, { excludes: excludesArg(argv) });
             console.log(argv.includes("--json") ? JSON.stringify(result, null, 2) : formatAuditReport(result));
             return 0;
         }
@@ -76,7 +84,7 @@ export async function main(argv, deps = {}) {
             return 0;
         }
         if (cmd === "graph" && dir) {
-            const r = await runGraph(dir);
+            const r = await runGraph(dir, { excludes: excludesArg(argv) });
             console.log(argv.includes("--json") ? JSON.stringify(r.graph, null, 2) : formatGraphSummary(r.graph, r.written));
             return 0;
         }
@@ -90,7 +98,7 @@ export async function main(argv, deps = {}) {
                         "Run without --llm for the deterministic map.");
                     return 1;
                 }
-                const source = new LocalDirFileSource(dir);
+                const source = new LocalDirFileSource(dir, { excludes: excludesArg(argv) });
                 const [profile, conventions, samples, tokens, designSamples] = await Promise.all([
                     analyze(source),
                     analyzeConventions(source),
@@ -109,7 +117,7 @@ export async function main(argv, deps = {}) {
                     return 1;
                 }
             }
-            const r = await runMap(dir, { dryRun: argv.includes("--dry-run"), narration, designNarration });
+            const r = await runMap(dir, { dryRun: argv.includes("--dry-run"), narration, designNarration, excludes: excludesArg(argv) });
             console.log(argv.includes("--json")
                 ? JSON.stringify({ profile: r.profile, conventions: r.conventions, tokens: r.tokens }, null, 2)
                 : argv.includes("--dry-run")

package/dist/graph.d.ts

@@ -5,6 +5,8 @@ export interface GraphResult {
     written: string[];
 }
 /** Scans `dir` and writes `.baselane/graph.json` + `.baselane/graph/GRAPH.md` through the containment guard. */
-export declare function runGraph(dir: string): Promise<GraphResult>;
+export declare function runGraph(dir: string, opts?: {
+    excludes?: string[];
+}): Promise<GraphResult>;
 /** One-screen human summary: totals + top fan-in + what was written. */
 export declare function formatGraphSummary(graph: ImportGraph, written: string[]): string;

package/dist/graph.js

@@ -3,8 +3,8 @@ import { dirname } from "node:path";
 import { LocalDirFileSource, buildImportGraph, renderGraphMd } from "@baselane/analyze";
 import { assertInsideDir } from "./apply.js";
 /** Scans `dir` and writes `.baselane/graph.json` + `.baselane/graph/GRAPH.md` through the containment guard. */
-export async function runGraph(dir) {
-    const graph = await buildImportGraph(new LocalDirFileSource(dir));
+export async function runGraph(dir, opts = {}) {
+    const graph = await buildImportGraph(new LocalDirFileSource(dir, { excludes: opts.excludes }));
     const outputs = [
         [".baselane/graph.json", JSON.stringify(graph, null, 2) + "\n"],
         [".baselane/graph/GRAPH.md", renderGraphMd(graph)],

package/dist/map.d.ts

@@ -11,5 +11,6 @@ export declare function runMap(dir: string, opts?: {
     dryRun?: boolean;
     narration?: NarrationSections | null;
     designNarration?: DesignNarration | null;
+    excludes?: string[];
 }): Promise<MapResult>;
 export declare function formatMapSummary(result: MapResult): string;

package/dist/map.js

@@ -1,10 +1,11 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { LocalDirFileSource, analyze, analyzeConventions, analyzeDesignTokens, buildImportGraph, renderArchitectureMd, renderDesignMd, DESIGN_REGION_ID, DESIGN_REGION_VERSION, SYSTEM_MAP_REGION_ID, SYSTEM_MAP_REGION_VERSION, } from "@baselane/analyze";
-import { mergeManagedRegion } from "@baselane/packs";
+import { buildManifest, extractManagedRegions, mergeManagedRegion, sha256Hex } from "@baselane/packs";
+import { readManifestWithFallback, targetLocation, writeManifestFile } from "@baselane/materialize";
 import { assertInsideDir } from "./apply.js";
 export async function runMap(dir, opts = {}) {
-    const source = new LocalDirFileSource(dir);
+    const source = new LocalDirFileSource(dir, { excludes: opts.excludes });
     const [profile, graph, conventions, tokens] = await Promise.all([
         analyze(source),
         buildImportGraph(source),
@@ -32,9 +33,49 @@ export async function runMap(dir, opts = {}) {
             await writeFile(abs, content, "utf8");
             written.push(rel);
         }
+        await recordMapRegionReceipts(dir, architectureMd, designMd);
     }
     return { profile, conventions, tokens, architectureMd, designMd, written };
 }
+/** Issue #1: capability outputs were invisible to drift — apply/map wrote ARCHITECTURE.md and
+ * DESIGN.md but recorded nothing, so hand-edits or deletions never surfaced. Record their managed
+ * regions into harness.json's managedRegions receipts (drift's regions loop already verifies any
+ * path listed there). Region receipts, not whole-file hashes: prose the developer writes OUTSIDE
+ * the region is theirs and must not flag. No-op when the target has no manifest yet — drift has
+ * nothing to run against until an apply/install creates one. */
+async function recordMapRegionReceipts(dir, architectureMd, designMd) {
+    const loc = targetLocation({ global: false, dir });
+    const { manifest: existing } = await readManifestWithFallback(loc);
+    if (existing === null)
+        return;
+    const managed = new Map(existing.materialized.managedRegions.map((m) => [m.path, m]));
+    const outputs = [["ARCHITECTURE.md", architectureMd]];
+    if (designMd !== null)
+        outputs.push(["DESIGN.md", designMd]);
+    for (const [path, content] of outputs) {
+        const regions = extractManagedRegions(content).map((r) => ({
+            packId: r.packId,
+            version: r.version,
+            sha256: sha256Hex(r.body),
+        }));
+        if (regions.length === 0)
+            continue;
+        const regionIds = new Set(regions.map((r) => r.packId));
+        const others = (managed.get(path)?.regions ?? []).filter((r) => !regionIds.has(r.packId));
+        managed.set(path, { path, regions: [...others, ...regions] });
+    }
+    const manifest = buildManifest({
+        target: loc.target,
+        packs: existing.packs,
+        registry: existing.registry,
+        capabilities: existing.capabilities,
+        receipt: {
+            ...existing.materialized,
+            managedRegions: [...managed.values()].sort((a, b) => a.path.localeCompare(b.path)),
+        },
+    });
+    await writeManifestFile(loc.manifestPath, manifest);
+}
 /** Reads a file, returning null (not throwing) when it does not exist. */
 async function readIfExists(path) {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baselane",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "Git-native package manager for AI coding harnesses — audit a repo, apply workflow packs, and keep agent config in sync.",
   "main": "./dist/index.js",
@@ -34,10 +34,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@baselane/analyze": "0.1.2",
-    "@baselane/distribute": "0.1.2",
-    "@baselane/packs": "0.1.2",
-    "@baselane/materialize": "0.1.2"
+    "@baselane/distribute": "0.1.3",
+    "@baselane/analyze": "0.1.3",
+    "@baselane/materialize": "0.1.3",
+    "@baselane/packs": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",