@momentiq/dark-factory-cli 2.0.0 → 2.1.0

package/dist/cycle-doc-validator/validate_cycle_doc.py

@@ -134,7 +134,17 @@ def _resolve_repo_root() -> Path:
 
 
 REPO_ROOT = _resolve_repo_root()
+# Cycle-doc lookup paths in priority order. Legacy `docs/roadmap/cycles/` is
+# tried first for backward compatibility with sage3c / dark-factory-platform;
+# `docs/cycles/` is the newer dark-factory-dashboard convention (PR #105
+# moved it there to align with the eventual upstream convention). Consumers
+# that have moved to the new path get a working validator without
+# configuration; consumers still on the legacy path are unchanged.
+CYCLE_DOC_DIRS: tuple[str, ...] = ("docs/roadmap/cycles", "docs/cycles")
 CYCLES_DIR = REPO_ROOT / "docs" / "roadmap" / "cycles"
+# Glob and the singular `CYCLES_DIR` retained for backward compatibility with
+# downstream tooling that imports them. New code should prefer `CYCLE_DOC_DIRS`
+# + `_is_cycle_doc_path()` which check both layouts.
 CYCLE_DOC_GLOB = "docs/roadmap/cycles/cycle*.md"
 
 # Trailers we recognize. ``git-interpret-trailers`` defines a trailer as
@@ -238,14 +248,27 @@ def normalize_cycle_id(raw: str) -> str | None:
 
 
 def find_cycle_doc(cycle_id: str) -> CycleDoc | None:
-    """Locate ``docs/roadmap/cycles/cycle<id>*.md`` and read its status."""
-    matches = sorted(CYCLES_DIR.glob(f"cycle{cycle_id}-*.md")) + sorted(
-        CYCLES_DIR.glob(f"cycle{cycle_id}.md")
-    )
+    """Locate ``<cycle_dir>/cycle<id>*.md`` and read its status.
+
+    Searches every candidate dir in ``CYCLE_DOC_DIRS`` (legacy
+    ``docs/roadmap/cycles/`` first, then ``docs/cycles/``) so consumers
+    that have moved get a working lookup without configuration. If the
+    same cycle exists in both dirs (transitional state), prefers the
+    longer-named match across all hits — same disambiguation rule as
+    before, just over a wider candidate set.
+    """
+    matches: list[Path] = []
+    for cycle_dir in CYCLE_DOC_DIRS:
+        dir_path = REPO_ROOT / cycle_dir
+        if not dir_path.exists():
+            continue
+        matches.extend(sorted(dir_path.glob(f"cycle{cycle_id}-*.md")))
+        matches.extend(sorted(dir_path.glob(f"cycle{cycle_id}.md")))
     if not matches:
         return None
-    # If multiple matches exist (legacy ``cycle318.md`` + new ``cycle318-foo.md``),
-    # prefer the one with the longer name (more descriptive slug).
+    # If multiple matches exist (legacy ``cycle318.md`` + new ``cycle318-foo.md``,
+    # or one in each layout), prefer the one with the longer name (more
+    # descriptive slug).
     path = max(matches, key=lambda p: len(p.name))
     status, superseded_by = read_cycle_frontmatter(path)
     return CycleDoc(path=path, status=status, superseded_by=superseded_by)
@@ -332,50 +355,89 @@ def base_cycle_doc(
     if gh_token:
         env["GH_TOKEN"] = gh_token
 
-    try:
-        listing_result = subprocess.run(
-            [
-                "gh",
-                "api",
-                f"repos/{repo}/contents/docs/roadmap/cycles?ref={base_ref}",
-            ],
-            check=True,
-            capture_output=True,
-            text=True,
-            env=env,
-            timeout=60,
+    # Collect candidates across EVERY candidate cycle-doc dir on the base
+    # ref — DON'T break on the first successful listing. A consumer can
+    # have BOTH layouts present (transitional state — e.g. dark-factory-
+    # dashboard pre-#105 had cycle1-5 at legacy + cycle6 at the new path
+    # for one PR's worth of overlap), and a legacy dir that exists but
+    # lacks the cited cycle (sage3c with cycle331.x at legacy + a new
+    # cycle 6 at the new path) must fall through to the next dir. Per-dir
+    # 404 is the normal "consumer has not moved (or has moved fully) to
+    # this layout" signal; only fail if EVERY dir 404s or any dir hits a
+    # non-404 error.
+    pattern = re.compile(rf"^cycle{re.escape(cycle_id)}(?:-.+)?\.md$")
+    candidates: list[dict] = []
+    dirs_listed: list[str] = []
+    last_404: BaseCycleDocFetchError | None = None
+    for cycle_dir in CYCLE_DOC_DIRS:
+        try:
+            listing_result = subprocess.run(
+                [
+                    "gh",
+                    "api",
+                    f"repos/{repo}/contents/{cycle_dir}?ref={base_ref}",
+                ],
+                check=True,
+                capture_output=True,
+                text=True,
+                env=env,
+                timeout=60,
+            )
+        except FileNotFoundError as exc:
+            # gh CLI itself missing — environmental, fail loud regardless
+            # of which cycle_dir we were probing.
+            raise BaseCycleDocFetchError(
+                "gh CLI not on PATH; cannot read cycle docs from base ref."
+            ) from exc
+        except subprocess.CalledProcessError as exc:
+            # Treat 404 (or "not found") as "this dir doesn't exist on
+            # base ref; keep trying the others". Any other non-zero exit
+            # (auth, rate-limit, server error) escapes immediately —
+            # don't silently swallow a real failure as a missing-dir.
+            if _is_gh_not_found_error(exc):
+                last_404 = BaseCycleDocFetchError(
+                    f"gh api repos/{repo}/contents/{cycle_dir} returned 404 "
+                    f"(exit {exc.returncode}): {(exc.stderr or '').strip()}"
+                )
+                continue
+            raise BaseCycleDocFetchError(
+                f"gh api repos/{repo}/contents/{cycle_dir} failed "
+                f"(exit {exc.returncode}): {(exc.stderr or '').strip()}"
+            ) from exc
+        except subprocess.TimeoutExpired as exc:
+            raise BaseCycleDocFetchError(
+                f"gh api repos/{repo}/contents/{cycle_dir} timed out after {exc.timeout}s"
+            ) from exc
+
+        dirs_listed.append(cycle_dir)
+        try:
+            entries = json.loads(listing_result.stdout)
+        except json.JSONDecodeError as exc:
+            raise BaseCycleDocFetchError(
+                f"GitHub contents API returned malformed JSON for {cycle_dir} listing."
+            ) from exc
+
+        candidates.extend(
+            entry
+            for entry in entries
+            if isinstance(entry, dict)
+            and entry.get("type") == "file"
+            and isinstance(entry.get("name"), str)
+            and pattern.match(entry["name"])
         )
-    except FileNotFoundError as exc:
-        raise BaseCycleDocFetchError(
-            "gh CLI not on PATH; cannot read cycle docs from base ref."
-        ) from exc
-    except subprocess.CalledProcessError as exc:
-        raise BaseCycleDocFetchError(
-            f"gh api repos/{repo}/contents/docs/roadmap/cycles failed "
-            f"(exit {exc.returncode}): {exc.stderr.strip()}"
-        ) from exc
-    except subprocess.TimeoutExpired as exc:
-        raise BaseCycleDocFetchError(
-            f"gh api repos/{repo}/contents/docs/roadmap/cycles timed out after {exc.timeout}s"
-        ) from exc
 
-    try:
-        entries = json.loads(listing_result.stdout)
-    except json.JSONDecodeError as exc:
-        raise BaseCycleDocFetchError(
-            "GitHub contents API returned malformed JSON for cycle docs listing."
-        ) from exc
+    if not dirs_listed:
+        # EVERY candidate dir 404'd — no cycle docs anywhere on base ref.
+        # Surface the last 404 so consumers see a concrete actionable error
+        # naming what was tried.
+        raise last_404 or BaseCycleDocFetchError(
+            "no candidate cycle-doc directory found on base ref "
+            f"(tried: {', '.join(CYCLE_DOC_DIRS)})"
+        )
 
-    pattern = re.compile(rf"^cycle{re.escape(cycle_id)}(?:-.+)?\.md$")
-    candidates = [
-        entry
-        for entry in entries
-        if isinstance(entry, dict)
-        and entry.get("type") == "file"
-        and isinstance(entry.get("name"), str)
-        and pattern.match(entry["name"])
-    ]
     if not candidates:
+        # At least one dir existed but doesn't hold the cited cycle —
+        # treat as "new cycle, OK to proceed" (the doc lands in this PR).
         return None
 
     chosen = max(candidates, key=lambda entry: len(entry["name"]))
@@ -657,18 +719,22 @@ def _parse_paginated_commit_messages(raw: str) -> str:
 
 
 def _is_cycle_doc_path(path: str) -> bool:
-    """Match ``docs/roadmap/cycles/cycle<id>(-<slug>)?.md``.
+    """Match ``<cycle_dir>/cycle<id>(-<slug>)?.md`` under any layout.
 
-    The classifier counts only files whose basename starts with
-    ``cycle`` followed by an id character. Sibling files like
-    ``docs/roadmap/cycles/README.md`` are index/meta content and do
-    NOT trigger the plan-PR contract.
+    Accepts both legacy ``docs/roadmap/cycles/`` and the newer
+    ``docs/cycles/`` per ``CYCLE_DOC_DIRS``. The classifier counts only
+    files whose basename starts with ``cycle`` followed by an id
+    character. Sibling files like ``<cycle_dir>/README.md`` are
+    index/meta content and do NOT trigger the plan-PR contract.
     """
-    prefix = "docs/roadmap/cycles/cycle"
-    if not path.startswith(prefix) or not path.endswith(".md"):
+    if not path.endswith(".md"):
         return False
-    next_char = path[len(prefix) : len(prefix) + 1]
-    return next_char.isdigit()
+    for cycle_dir in CYCLE_DOC_DIRS:
+        prefix = f"{cycle_dir}/cycle"
+        if path.startswith(prefix):
+            next_char = path[len(prefix) : len(prefix) + 1]
+            return next_char.isdigit()
+    return False
 
 
 def is_plan_pr(
@@ -731,7 +797,9 @@ def status_completion_in_diff(diff: str) -> list[str]:
             in_frontmatter = False
             seen_completed_in_frontmatter = False
             continue
-        if not current_file or not current_file.startswith("docs/roadmap/cycles/"):
+        if not current_file or not any(
+            current_file.startswith(f"{d}/") for d in CYCLE_DOC_DIRS
+        ):
             continue
         # Naive frontmatter tracking inside the diff hunk: ``---`` delimiters
         # toggle the flag. False positives are acceptable here — the goal
@@ -789,7 +857,7 @@ def cycle_docs_transitioned_to_terminal(
     cycle_paths = [
         p
         for p in changed_files
-        if p.startswith("docs/roadmap/cycles/cycle") and p.endswith(".md")
+        if any(p.startswith(f"{d}/cycle") for d in CYCLE_DOC_DIRS) and p.endswith(".md")
     ]
     if not cycle_paths:
         return []
@@ -1030,8 +1098,9 @@ def validate(
         if doc is None:
             errors.append(
                 f"[cycle-doc] FAIL ({pr_type}): cycle `{cycle_id}` not found in "
-                f"`docs/roadmap/cycles/`. Either fix the trailer or open a plan "
-                "PR that creates the cycle doc first."
+                f"any of: {', '.join(f'`{d}/`' for d in CYCLE_DOC_DIRS)}. "
+                "Either fix the trailer or open a plan PR that creates the "
+                "cycle doc first."
             )
             return errors
 
@@ -1056,7 +1125,9 @@ def validate(
         # PR that doesn't touch its cycle's doc is mis-labelled.
         assert doc is not None  # plan PR without cycle_id already returned
         cycle_paths = [
-            f for f in changed_files if f.startswith("docs/roadmap/cycles/")
+            f
+            for f in changed_files
+            if any(f.startswith(f"{d}/") for d in CYCLE_DOC_DIRS)
         ]
         doc_relative = doc.path.relative_to(REPO_ROOT).as_posix()
         if doc_relative not in cycle_paths:

package/dist/onboard/analyze.d.ts

@@ -0,0 +1,7 @@
+import { type Analyzer } from "./analyzer.js";
+import { type RepoAnalysis } from "./schema.js";
+declare const ALL_ANALYZERS: Analyzer[];
+export declare const REPO_ANALYSIS_BYTE_BUDGET = 16384;
+export declare function analyze(rootDir: string, analyzers?: Analyzer[]): Promise<RepoAnalysis>;
+export { ALL_ANALYZERS };
+//# sourceMappingURL=analyze.d.ts.map

package/dist/onboard/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/onboard/analyze.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AAQrB,QAAA,MAAM,aAAa,YAOlB,CAAC;AAOF,eAAO,MAAM,yBAAyB,QAAS,CAAC;AA8BhD,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,QAAQ,EAAkB,GACpC,OAAO,CAAC,YAAY,CAAC,CA8BvB;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/onboard/analyze.js

@@ -0,0 +1,86 @@
+// analyze() orchestrator — cycle 15 Phase A.
+//
+// Pulls the 6 domain analyzers together, surfaces failures as a first-class
+// `analyzerErrors` field (never silently dropped), enforces the 16 KB
+// serialized-size budget as a final backstop, returns a Zod-validated
+// RepoAnalysis.
+import { runAnalyzers } from "./analyzer.js";
+import { RepoAnalysisSchema, AGENT_CONTEXT_SCHEMA_VERSION, } from "./schema.js";
+import { manifestAnalyzer } from "./analyzers/manifest.js";
+import { lockfileAnalyzer } from "./analyzers/lockfile.js";
+import { ciAnalyzer } from "./analyzers/ci.js";
+import { treeAnalyzer } from "./analyzers/tree.js";
+import { gitAnalyzer } from "./analyzers/git.js";
+import { docsAnalyzer } from "./analyzers/docs.js";
+const ALL_ANALYZERS = [
+    manifestAnalyzer,
+    lockfileAnalyzer,
+    ciAnalyzer,
+    treeAnalyzer,
+    gitAnalyzer,
+    docsAnalyzer,
+];
+// The 16 KB serialized-size budget is a hard contract (cycle 15 D2 line 154,
+// exit criterion "RepoAnalysis JSON of bounded size (≤ 16 KB)"). The per-array
+// .max() caps on the Zod schema prevent the common overflow paths; this final
+// enforcement is the backstop for unforeseen growth (giant headings, very long
+// canonicalName, etc.) so a partial silent-truncation can never reach Phase B.
+export const REPO_ANALYSIS_BYTE_BUDGET = 16_384;
+function emptyBase(rootDir) {
+    return {
+        schemaVersion: AGENT_CONTEXT_SCHEMA_VERSION,
+        repoRoot: rootDir,
+        canonicalName: "",
+        stacks: [],
+        services: [],
+        dependencies: [],
+        ci: { workflows: [], deployStory: null },
+        tree: { topLevelDirs: [], languageBreakdown: {}, testDirs: [], fileCount: 0 },
+        git: {
+            recentCommitConventions: { conventional: false, cycleReferenced: false },
+            defaultBranch: "main",
+        },
+        docs: {
+            existing: [],
+            hasClaudeMd: false,
+            hasAgentsMd: false,
+            agentContextSetPresent: false,
+            claudeMd: null,
+            agentsMd: null,
+        },
+        dfPresence: { hooks: false, configJson: false, prWorkflow: false, cliPin: null },
+        decisions: [],
+        analyzerErrors: [],
+    };
+}
+export async function analyze(rootDir, analyzers = ALL_ANALYZERS) {
+    const merged = await runAnalyzers(rootDir, analyzers);
+    // Surface analyzer failures as a first-class schema field; never drop them.
+    // The orchestrator does NOT throw on per-analyzer errors — partial-result
+    // reporting is the contract — but the field's presence is the loud signal
+    // Phase B and CLI consumers branch on.
+    const { __analyzerErrors, ...rest } = merged;
+    const base = emptyBase(rootDir);
+    const combined = {
+        ...base,
+        ...rest,
+        // Each top-level object field needs explicit merge so partial analyzers
+        // don't blow away the defaults from emptyBase.
+        ci: { ...base.ci, ...(rest.ci ?? {}) },
+        tree: { ...base.tree, ...(rest.tree ?? {}) },
+        git: { ...base.git, ...(rest.git ?? {}) },
+        docs: { ...base.docs, ...(rest.docs ?? {}) },
+        dfPresence: { ...base.dfPresence, ...(rest.dfPresence ?? {}) },
+        analyzerErrors: __analyzerErrors ?? [],
+    };
+    const parsed = RepoAnalysisSchema.parse(combined);
+    const json = JSON.stringify(parsed);
+    if (json.length > REPO_ANALYSIS_BYTE_BUDGET) {
+        throw new Error(`RepoAnalysis exceeds ${REPO_ANALYSIS_BYTE_BUDGET}-byte budget: produced ${json.length} bytes. ` +
+            "Likely cause: oversized headings/decisions/dependencies; rerun against a bounded subset or " +
+            "tighten analyzer caps. (cycle 15 D2 / exit criterion)");
+    }
+    return parsed;
+}
+export { ALL_ANALYZERS };
+//# sourceMappingURL=analyze.js.map

package/dist/onboard/analyze.js.map

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

package/dist/onboard/analyzer.d.ts

@@ -0,0 +1,15 @@
+import type { RepoAnalysis, AnalyzerError } from "./schema.js";
+export interface Analyzer {
+    name: string;
+    /**
+     * Return `null` to opt out (e.g. no `package.json` → manifest analyzer's
+     * JS branch skips). Return a `Partial<RepoAnalysis>` to contribute fields;
+     * the orchestrator merges all contributions.
+     */
+    detect(rootDir: string): Promise<Partial<RepoAnalysis> | null>;
+}
+export type MergedAnalysis = Partial<RepoAnalysis> & {
+    __analyzerErrors?: AnalyzerError[];
+};
+export declare function runAnalyzers(rootDir: string, analyzers: Analyzer[]): Promise<MergedAnalysis>;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/onboard/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/onboard/analyzer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;CAChE;AAKD,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG;IACnD,gBAAgB,CAAC,EAAE,aAAa,EAAE,CAAC;CACpC,CAAC;AAEF,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,QAAQ,EAAE,GACpB,OAAO,CAAC,cAAc,CAAC,CA+BzB"}

package/dist/onboard/analyzer.js

@@ -0,0 +1,52 @@
+export async function runAnalyzers(rootDir, analyzers) {
+    const results = await Promise.all(analyzers.map(async (a) => {
+        try {
+            return {
+                name: a.name,
+                value: await a.detect(rootDir),
+                error: null,
+            };
+        }
+        catch (e) {
+            return {
+                name: a.name,
+                value: null,
+                error: e instanceof Error ? e.message : String(e),
+            };
+        }
+    }));
+    const merged = {};
+    const errors = [];
+    for (const r of results) {
+        if (r.error !== null) {
+            errors.push({ name: r.name, error: r.error });
+            continue;
+        }
+        if (r.value === null)
+            continue;
+        mergeInto(merged, r.value);
+    }
+    if (errors.length > 0)
+        merged.__analyzerErrors = errors;
+    return merged;
+}
+function mergeInto(target, source) {
+    for (const [key, value] of Object.entries(source)) {
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            const existing = target[key] ?? [];
+            target[key] = [...existing, ...value];
+        }
+        else if (typeof value === "object" &&
+            value !== null &&
+            !Array.isArray(value)) {
+            const existing = target[key] ?? {};
+            target[key] = { ...existing, ...value };
+        }
+        else {
+            target[key] = value;
+        }
+    }
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/onboard/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../../src/onboard/analyzer.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,SAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC9B,KAAK,EAAE,IAAqB;aAC7B,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aAClD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9C,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;YAAE,SAAS;QAC/B,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC;IACxD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAChB,MAAsB,EACtB,MAA6B;IAE7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAG7C,EAAE,CAAC;QACJ,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAI,MAAM,CAAC,GAAG,CAA2B,IAAI,EAAE,CAAC;YAC7D,MAAkC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC;QACrE,CAAC;aAAM,IACL,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACrB,CAAC;YACD,MAAM,QAAQ,GACX,MAAM,CAAC,GAAG,CAAyC,IAAI,EAAE,CAAC;YAC5D,MAAkC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;QACvE,CAAC;aAAM,CAAC;YACL,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/onboard/analyzers/ci.d.ts

@@ -0,0 +1,3 @@
+import type { Analyzer } from "../analyzer.js";
+export declare const ciAnalyzer: Analyzer;
+//# sourceMappingURL=ci.d.ts.map

package/dist/onboard/analyzers/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../../src/onboard/analyzers/ci.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAc/C,eAAO,MAAM,UAAU,EAAE,QA8CxB,CAAC"}

package/dist/onboard/analyzers/ci.js

@@ -0,0 +1,112 @@
+// packages/cli/src/onboard/analyzers/ci.ts
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+const DEPLOY_VERBS = [
+    { re: /\bhelm\s+(upgrade|install)\b/, target: "helm" },
+    { re: /\bgh\s+release\s+create\b/, target: "gh-release" },
+    { re: /\bgcloud\s+run\s+deploy\b/, target: "gcloud-run" },
+    { re: /\bgcloud\s+builds\s+submit\b/, target: "gcloud-run" },
+    { re: /\baws\s+ecs\s+update-service\b/, target: "ecs" },
+    { re: /\bvercel\s+deploy\b/, target: "vercel" },
+    { re: /\bflyctl\s+deploy\b/, target: "fly" },
+    { re: /\bkubectl\s+apply\b/, target: "kubernetes" },
+];
+export const ciAnalyzer = {
+    name: "ci",
+    async detect(rootDir) {
+        const wfDir = join(rootDir, ".github", "workflows");
+        let entries;
+        try {
+            entries = (await readdir(wfDir)).filter((f) => f.endsWith(".yml") || f.endsWith(".yaml"));
+        }
+        catch {
+            return null;
+        }
+        if (entries.length === 0)
+            return null;
+        const workflows = [];
+        let deployStory = null;
+        for (const name of entries) {
+            const path = join(wfDir, name);
+            const raw = await readFile(path, "utf8");
+            let parsed;
+            try {
+                parsed = parseYaml(raw);
+            }
+            catch {
+                continue;
+            }
+            if (!parsed || typeof parsed !== "object")
+                continue;
+            const p = parsed;
+            const triggers = normalizeTriggers(p.on);
+            const jobs = Object.keys(p.jobs ?? {});
+            const matrixDimensions = collectMatrixDims(p);
+            workflows.push({
+                name: typeof p.name === "string" ? p.name : name,
+                path: `.github/workflows/${name}`,
+                triggers,
+                jobs,
+                matrixDimensions,
+            });
+            if (!deployStory) {
+                deployStory = findDeployCommand(p, `.github/workflows/${name}`);
+            }
+        }
+        return { ci: { workflows, deployStory } };
+    },
+};
+function normalizeTriggers(on) {
+    if (typeof on === "string")
+        return [on];
+    if (Array.isArray(on))
+        return on.filter((x) => typeof x === "string");
+    if (on && typeof on === "object")
+        return Object.keys(on);
+    return [];
+}
+function collectMatrixDims(parsed) {
+    const dims = new Set();
+    const jobs = parsed.jobs ?? {};
+    for (const job of Object.values(jobs)) {
+        if (!job || typeof job !== "object")
+            continue;
+        const strategy = job.strategy;
+        if (!strategy || typeof strategy !== "object")
+            continue;
+        const matrix = strategy.matrix;
+        if (!matrix || typeof matrix !== "object")
+            continue;
+        for (const k of Object.keys(matrix)) {
+            if (k !== "include" && k !== "exclude")
+                dims.add(k);
+        }
+    }
+    return [...dims];
+}
+function findDeployCommand(parsed, workflowPath) {
+    const jobs = parsed.jobs ?? {};
+    for (const job of Object.values(jobs)) {
+        if (!job || typeof job !== "object")
+            continue;
+        const steps = job.steps;
+        if (!Array.isArray(steps))
+            continue;
+        for (const step of steps) {
+            if (!step || typeof step !== "object")
+                continue;
+            const run = step.run;
+            if (typeof run !== "string")
+                continue;
+            for (const line of run.split(/\n/)) {
+                for (const { re, target } of DEPLOY_VERBS) {
+                    if (re.test(line))
+                        return { workflowPath, command: line.trim(), target };
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=ci.js.map

package/dist/onboard/analyzers/ci.js.map

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

package/dist/onboard/analyzers/docs.d.ts

@@ -0,0 +1,3 @@
+import type { Analyzer } from "../analyzer.js";
+export declare const docsAnalyzer: Analyzer;
+//# sourceMappingURL=docs.d.ts.map

package/dist/onboard/analyzers/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/onboard/analyzers/docs.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA8F/C,eAAO,MAAM,YAAY,EAAE,QAsD1B,CAAC"}