@ai-dossier/cli 0.81.0 → 0.83.0

package/dist/workspace-layout.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Workspace layout of a target repo, read from its own workspace config (#801) instead of guessed
+ * from path shapes. `batch compose` ranks backfill by "shares a workspace package"; the old path
+ * heuristic (`…/packages/<x>/…` → `packages/<x>`, else the first path segment) collapsed every path
+ * outside `packages/` on imboard's nested layout (`main/packages/…`, `main/scripts/…`) into a
+ * pseudo-package `main` that nearly every issue "shared".
+ *
+ * Pure and dependency-light (only `yaml`): no `gh`, network or fs. The command layer supplies a
+ * {@link WorkspaceFileReader} over `gh api repos/<r>/contents/…` (target repo not local) or the
+ * local checkout, so discovery is unit-testable with an in-memory reader.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseWorkspaceConfig = parseWorkspaceConfig;
+exports.discoverWorkspaceLayout = discoverWorkspaceLayout;
+exports.packageOfPath = packageOfPath;
+const yaml_1 = require("yaml");
+/** Config files probed in each candidate directory, in precedence order. */
+const CONFIG_FILES = ['pnpm-workspace.yaml', 'package.json', 'lerna.json'];
+/** Top-level directories never probed for a nested workspace root — docs/tooling, not code roots. */
+const SKIP_DIRS = new Set([
+    'node_modules',
+    'docs',
+    'doc',
+    'scripts',
+    'test',
+    'tests',
+    'examples',
+    'vendor',
+    'dist',
+    'build',
+    'terraform',
+    'infra',
+]);
+/** Nested roots probed at most (each costs up to three `gh api` reads: pnpm, package.json, lerna). */
+const MAX_PROBED_DIRS = 8;
+/** Globs kept per root — the config is untrusted-ish network text, keep the output bounded. */
+const MAX_GLOBS = 64;
+/** Split declared patterns into includes and `!` excludes; drops non-strings, blanks, and `./` prefixes. */
+function toPatterns(value) {
+    if (!Array.isArray(value))
+        return null;
+    const globs = [];
+    const excludes = [];
+    for (const raw of value) {
+        if (typeof raw !== 'string')
+            continue;
+        const trimmed = raw.trim().replace(/^\.\//, '').replace(/\/+$/, '');
+        if (trimmed === '' || trimmed === '!')
+            continue;
+        if (trimmed.startsWith('!'))
+            excludes.push(trimmed.slice(1).replace(/^\.\//, ''));
+        else
+            globs.push(trimmed);
+    }
+    return globs.length > 0
+        ? { globs: globs.slice(0, MAX_GLOBS), excludes: excludes.slice(0, MAX_GLOBS) }
+        : null;
+}
+/**
+ * Workspace patterns declared by one config file's text, or null when it declares none.
+ * `package.json` accepts both `workspaces: [...]` and the Yarn `workspaces: { packages: [...] }` shape.
+ */
+function parseWorkspaceConfig(file, text) {
+    try {
+        if (file === 'pnpm-workspace.yaml') {
+            const doc = (0, yaml_1.parse)(text);
+            return toPatterns(doc?.packages);
+        }
+        const doc = JSON.parse(text);
+        if (file === 'lerna.json')
+            return toPatterns(doc?.packages);
+        const ws = doc?.workspaces;
+        return toPatterns(Array.isArray(ws) ? ws : ws?.packages);
+    }
+    catch {
+        return null;
+    }
+}
+function probeRoot(prefix, reader) {
+    for (const file of CONFIG_FILES) {
+        const text = reader.readFile(prefix === '' ? file : `${prefix}/${file}`);
+        if (text === null)
+            continue;
+        const patterns = parseWorkspaceConfig(file, text);
+        if (patterns !== null)
+            return { prefix, file, ...patterns };
+    }
+    return null;
+}
+/**
+ * Find the workspace root(s) of a repo: the repo root when it declares workspaces, otherwise each
+ * top-level directory that does (imboard's `main/`). Null when no config is found anywhere — the
+ * caller then falls back to path heuristics and says so.
+ */
+function discoverWorkspaceLayout(reader) {
+    const root = probeRoot('', reader);
+    if (root !== null)
+        return { roots: [root] };
+    const dirs = (reader.topLevelDirs() ?? [])
+        .filter((d) => !d.startsWith('.') && !SKIP_DIRS.has(d))
+        .sort()
+        .slice(0, MAX_PROBED_DIRS);
+    const roots = dirs.map((d) => probeRoot(d, reader)).filter((r) => r !== null);
+    return roots.length > 0 ? { roots } : null;
+}
+// --- path → package ----------------------------------------------------------------------------
+/** One glob segment as a regex: `*` matches within the segment, everything else literally. */
+function segmentMatches(pattern, segment) {
+    if (pattern === segment)
+        return true;
+    if (!pattern.includes('*'))
+        return false;
+    const re = pattern
+        .split('*')
+        .map((part) => part.replace(/[.+?^${}()|[\]\\]/g, '\\$&'))
+        .join('[^/]*');
+    return new RegExp(`^${re}$`).test(segment);
+}
+/**
+ * Number of leading path segments a glob claims as the package directory, or null when the path
+ * is not under it. A trailing `**` claims the first segment beneath its literal prefix; a `**`
+ * elsewhere is treated as `*` (package dirs are one level per pattern segment).
+ */
+function globMatch(glob, segments) {
+    const parts = glob.split('/').filter((p) => p !== '');
+    let claimed = 0;
+    for (let i = 0; i < parts.length; i++) {
+        if (i >= segments.length)
+            return null;
+        if (parts[i] === '**') {
+            if (i === parts.length - 1)
+                return segments.length > i ? i + 1 : null;
+            claimed = i + 1;
+            continue;
+        }
+        if (!segmentMatches(parts[i], segments[i]))
+            return null;
+        claimed = i + 1;
+    }
+    return claimed;
+}
+/** A trailing segment that looks like a file, so `packages/README.md` is not read as package `README.md`. */
+const FILE_LIKE_RE = /\.[A-Za-z0-9]{1,6}$/;
+function packageDirIn(root, relative) {
+    let best = null;
+    for (const glob of root.globs) {
+        const n = globMatch(glob, relative);
+        if (n === null || (n === relative.length && FILE_LIKE_RE.test(relative[n - 1])))
+            continue;
+        if (best === null || n > best)
+            best = n;
+    }
+    if (best === null)
+        return null;
+    const dir = relative.slice(0, best);
+    for (const glob of root.excludes) {
+        if (globMatch(glob, dir) === dir.length)
+            return null;
+    }
+    return dir.join('/');
+}
+/**
+ * The declared workspace package a repo-relative path belongs to, or null when it is outside every
+ * declared workspace (root scripts, docs, CI — deliberately NOT a pseudo-package). A path may name
+ * the workspace root's directory (`main/packages/x/…`) or omit it (`packages/x/…`, how issue text
+ * usually spells it). With more than one root the package is prefixed with its root's directory.
+ */
+function packageOfPath(path, layout) {
+    const segments = path
+        .replace(/^\.\//, '')
+        .split('/')
+        .filter((s) => s !== '');
+    const qualify = (root, dir) => layout.roots.length > 1 && root.prefix !== '' ? `${root.prefix}/${dir}` : dir;
+    // Pass 1: a root whose directory the path names. This wins outright, so root ORDER never
+    // matters (`main/packages/x` is `main`'s, even when another root's glob would also match it).
+    for (const root of layout.roots) {
+        const prefixSegments = root.prefix === '' ? [] : root.prefix.split('/');
+        if (prefixSegments.length === 0 || !prefixSegments.every((p, i) => segments[i] === p))
+            continue;
+        const dir = packageDirIn(root, segments.slice(prefixSegments.length));
+        if (dir !== null)
+            return qualify(root, dir);
+    }
+    // Pass 2: a root-relative spelling (`packages/x/…`, how issue text usually writes it). Ambiguous
+    // across roots (`a` and `b` both declare `packages/*`) means unknown, not "the first root".
+    const hits = layout.roots
+        .map((root) => [root, packageDirIn(root, segments)])
+        .filter((h) => h[1] !== null);
+    return hits.length === 1 ? qualify(hits[0][0], hits[0][1]) : null;
+}
+//# sourceMappingURL=workspace-layout.js.map

package/dist/workspace-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-layout.js","sourceRoot":"","sources":["../src/workspace-layout.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAyEH,oDAkBC;AAiBD,0DASC;AA4DD,sCAqBC;AApMD,+BAA0C;AAkB1C,4EAA4E;AAC5E,MAAM,YAAY,GAAG,CAAC,qBAAqB,EAAE,cAAc,EAAE,YAAY,CAAU,CAAC;AAEpF,qGAAqG;AACrG,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,cAAc;IACd,MAAM;IACN,KAAK;IACL,SAAS;IACT,MAAM;IACN,OAAO;IACP,UAAU;IACV,QAAQ;IACR,MAAM;IACN,OAAO;IACP,WAAW;IACX,OAAO;CACR,CAAC,CAAC;AAEH,sGAAsG;AACtG,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,+FAA+F;AAC/F,MAAM,SAAS,GAAG,EAAE,CAAC;AAUrB,4GAA4G;AAC5G,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QACtC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpE,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;YAAE,SAAS;QAChD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;;YAC7E,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE;QAC9E,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,IAAmC,EACnC,IAAY;IAEZ,IAAI,CAAC;QACH,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,IAAA,YAAS,EAAC,IAAI,CAAkC,CAAC;YAC7D,OAAO,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwD,CAAC;QACpF,IAAI,IAAI,KAAK,YAAY;YAAE,OAAO,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5D,MAAM,EAAE,GAAG,GAAG,EAAE,UAAU,CAAC;QAC3B,OAAO,UAAU,CACf,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,EAAyC,EAAE,QAAQ,CAC9E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAAc,EAAE,MAA2B;IAC5D,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC5B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClD,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,MAA2B;IACjE,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;SACvC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACtD,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAClG,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,kGAAkG;AAElG,8FAA8F;AAC9F,SAAS,cAAc,CAAC,OAAe,EAAE,OAAe;IACtD,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,EAAE,GAAG,OAAO;SACf,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;SACzD,IAAI,CAAC,OAAO,CAAC,CAAC;IACjB,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAY,EAAE,QAAkB;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACtD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACtE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACxD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6GAA6G;AAC7G,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAE3C,SAAS,YAAY,CAAC,IAAmB,EAAE,QAAkB;IAC3D,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS;QAC1F,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,IAAY,EAAE,MAAuB;IACjE,MAAM,QAAQ,GAAG,IAAI;SAClB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,CAAC,IAAmB,EAAE,GAAW,EAAE,EAAE,CACnD,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAChF,yFAAyF;IACzF,8FAA8F;IAC9F,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxE,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAAE,SAAS;QAChG,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QACtE,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,iGAAiG;IACjG,4FAA4F;IAC5F,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK;SACtB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAU,CAAC;SAC5D,MAAM,CAAC,CAAC,CAAC,EAAyC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-dossier/cli",
-  "version": "0.81.0",
+  "version": "0.83.0",
   "description": "Create, verify, sign, publish, and run dossiers — portable, signed, versioned skills for any LLM tool. The dossier ⇄ Claude Code skill bridge (install-skill / skill-export).",
   "main": "dist/cli.js",
   "bin": {