@seanmars/tospec 0.19.0-beta.8 → 0.20.0

package/dist/core/config-schema.js

@@ -1,8 +1,5 @@
 import { z } from 'zod';
-/**
- * Zod schema for global Tospec configuration.
- * Uses passthrough() to preserve unknown fields for forward compatibility.
- */
+/** passthrough() preserves unknown fields, for forward compatibility. */
 export const GlobalConfigSchema = z
     .object({
     profile: z
@@ -14,9 +11,6 @@ export const GlobalConfigSchema = z
         .optional(),
 })
     .passthrough();
-/**
- * Default configuration values.
- */
 export const DEFAULT_CONFIG = {
     profile: 'core',
 };
@@ -31,16 +25,12 @@ function hasUnsafeSegment(keys) {
 }
 /**
  * True when a dot-notation key path contains a prototype-reaching segment.
- * Callers that bypass key validation (e.g. --allow-unknown) still must not
- * bypass this.
+ * `--allow-unknown` relaxes key validation, never this.
  */
 export function hasUnsafeKeySegment(path) {
     return hasUnsafeSegment(path.split('.'));
 }
-/**
- * Validate a config key path for CLI set operations.
- * Unknown top-level keys are rejected unless explicitly allowed by the caller.
- */
+/** Unknown top-level keys are rejected unless the caller allows them. */
 export function validateConfigKeyPath(path) {
     const rawKeys = path.split('.');
     if (rawKeys.length === 0 || rawKeys.some((key) => key.trim() === '')) {
@@ -59,13 +49,7 @@ export function validateConfigKeyPath(path) {
     }
     return { valid: true };
 }
-/**
- * Get a nested value from an object using dot notation.
- *
- * @param obj - The object to access
- * @param path - Dot-separated path (e.g., "featureFlags.someFlag")
- * @returns The value at the path, or undefined if not found
- */
+/** Reads `obj` at a dot-separated path, e.g. "featureFlags.someFlag". */
 export function getNestedValue(obj, path) {
     const keys = path.split('.');
     if (hasUnsafeSegment(keys)) {
@@ -83,19 +67,12 @@ export function getNestedValue(obj, path) {
     }
     return current;
 }
-/**
- * Set a nested value in an object using dot notation.
- * Creates intermediate objects as needed.
- *
- * @param obj - The object to modify (mutated in place)
- * @param path - Dot-separated path (e.g., "featureFlags.someFlag")
- * @param value - The value to set
- */
+/** Writes `obj` at a dot-separated path, creating intermediate objects. */
 export function setNestedValue(obj, path, value) {
     const keys = path.split('.');
-    // Compared literally rather than through a helper, so the guard is plain to a
-    // reader and to static analysis. Checked for the whole path before anything is
-    // written, so a rejected key never leaves half-created objects behind.
+    // Compared literally rather than through a helper, so the guard is plain to
+    // static analysis. Checked for the whole path before anything is written, so
+    // a rejected key leaves no half-created objects.
     for (const key of keys) {
         if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
             return;
@@ -112,13 +89,7 @@ export function setNestedValue(obj, path, value) {
     const lastKey = keys[keys.length - 1];
     current[lastKey] = value;
 }
-/**
- * Delete a nested value from an object using dot notation.
- *
- * @param obj - The object to modify (mutated in place)
- * @param path - Dot-separated path (e.g., "featureFlags.someFlag")
- * @returns true if the key existed and was deleted, false otherwise
- */
+/** Deletes `obj`'s value at a dot-separated path; false when it was absent. */
 export function deleteNestedValue(obj, path) {
     const keys = path.split('.');
     for (const key of keys) {
@@ -127,38 +98,37 @@ export function deleteNestedValue(obj, path) {
         }
     }
     let current = obj;
+    // Every container on the way down, so emptied parents can be pruned after
+    // the leaf goes: `unset foo.bar` used to leave `foo: {}` behind, a key
+    // `config list` then showed as if the user had set it.
+    const trail = [];
     for (let i = 0; i < keys.length - 1; i++) {
         const key = keys[i];
         if (current[key] === undefined || current[key] === null || typeof current[key] !== 'object') {
             return false;
         }
+        trail.push({ parent: current, key });
         current = current[key];
     }
     const lastKey = keys[keys.length - 1];
-    if (lastKey in current) {
-        delete current[lastKey];
-        return true;
+    if (!(lastKey in current)) {
+        return false;
+    }
+    delete current[lastKey];
+    for (let i = trail.length - 1; i >= 0; i--) {
+        const { parent, key } = trail[i];
+        const container = parent[key];
+        if (Object.keys(container).length > 0)
+            break;
+        delete parent[key];
     }
-    return false;
+    return true;
 }
 /**
- * Coerce a string value to its appropriate type.
- * - "true" / "false" -> boolean
- * - Numeric strings -> number
- * - JSON arrays/objects -> parsed containers
- * - Everything else -> string
- *
- * @param value - The string value to coerce
- * @param forceString - If true, always return the value as a string
- * @returns The coerced value
- */
-/**
- * Config keys whose value is a list.
- *
- * Splitting on commas cannot be decided from the value alone: a string key such
- * as `context` may legitimately contain commas, and turning that into an array
- * would corrupt it. So the decision is keyed on the field, from the same schema
- * that validates the result.
+ * Config keys whose value is a list. Splitting on commas cannot be decided from
+ * the value alone — a string key such as `context` may legitimately contain
+ * them — so the decision is keyed on the field, read from the same schema that
+ * validates the result.
  */
 const ARRAY_VALUED_KEYS = new Set(Object.entries(GlobalConfigSchema.shape)
     .filter(([, field]) => {
@@ -167,18 +137,18 @@ const ARRAY_VALUED_KEYS = new Set(Object.entries(GlobalConfigSchema.shape)
     return inner instanceof z.ZodArray;
 })
     .map(([name]) => name));
+/** Reads a CLI string as a boolean, number, JSON container, list, or string. */
 export function coerceValue(value, forceString = false, key) {
     if (forceString) {
         return value;
     }
-    // Boolean coercion
     if (value === 'true') {
         return true;
     }
     if (value === 'false') {
         return false;
     }
-    // Number coercion - must be a valid finite number
+    // Finite numbers only; `''`, `'NaN'` and `'Infinity'` stay strings.
     const num = Number(value);
     if (!isNaN(num) && isFinite(num) && value.trim() !== '') {
         return num;
@@ -187,11 +157,9 @@ export function coerceValue(value, forceString = false, key) {
     if (jsonContainer !== undefined) {
         return jsonContainer;
     }
-    // A comma-separated list for a list-valued key. `--tools a,b,c` already reads
-    // this way, so requiring a JSON array here made the one syntax the CLI teaches
-    // elsewhere fail with a type error that named neither the key nor the
-    // accepted form. JSON is tried first (above), so an explicit array literal
-    // still wins and `--string` still opts out entirely.
+    // `--tools a,b,c` already reads this way, so requiring a JSON array would make
+    // the syntax the CLI teaches elsewhere fail with a type error. JSON is tried
+    // first, so an explicit array literal still wins and `--string` opts out.
     if (key !== undefined && ARRAY_VALUED_KEYS.has(key)) {
         return value
             .split(',')
@@ -221,12 +189,6 @@ function parseJsonContainer(value) {
     }
     return undefined;
 }
-/**
- * Validate a configuration object against the schema.
- *
- * @param config - The configuration to validate
- * @returns Validation result with success status and optional error message
- */
 export function validateConfig(config) {
     try {
         GlobalConfigSchema.parse(config);
@@ -234,8 +196,7 @@ export function validateConfig(config) {
     }
     catch (error) {
         if (error instanceof z.ZodError) {
-            const zodError = error;
-            const messages = zodError.issues.map((e) => `${e.path.join('.')}: ${e.message}`);
+            const messages = error.issues.map((e) => `${e.path.join('.')}: ${e.message}`);
             return { success: false, error: messages.join('; ') };
         }
         return { success: false, error: 'Unknown validation error' };

package/dist/core/config-schema.js.map

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

package/dist/core/config.d.ts

@@ -5,35 +5,22 @@ export declare const TOSPEC_DIR_NAME = "tospec";
  */
 export declare const TOOL_RULES_SUBDIR: readonly ['rules', 'tospec'];
 /**
- * The workflow rule document, written for every configured tool by init, update
- * and rules, and removed by none of them.
- *
- * Shared rather than spelled out at each use because it is two things at once:
- * the write target for rules-generation, and the durable proof that tospec
- * currently manages a tool dir (`isToolInstalled`). Specifically this file and
- * not the `rules/tospec/` directory: that directory also holds `decision.md`,
- * which an older tospec wrote from init only — its presence says tospec touched
- * the dir once, not that it manages it now. The two readings only agree while
- * both sides read the name from here.
+ * The workflow rule document: both the write target for rules-generation and the
+ * proof that tospec currently manages a tool dir (`isToolInstalled`). This file,
+ * not the `rules/tospec/` directory, whose other contents only prove tospec
+ * touched the dir once.
  */
 export declare const WORKFLOW_RULE_FILENAME = "single-source-of-truth.md";
 /**
- * The same document under its previous, misspelled name (`sourc`).
- *
- * Kept so init/update/rules can retire a copy an older tospec wrote instead of
- * leaving it beside the corrected one, where two rule files with the same body
- * would both be loaded. Detection accepts it too, so a project that has not been
- * updated yet still reads as installed.
+ * The same document under its previous, misspelled name. Kept so init/update can
+ * retire an older copy instead of loading two rule files with the same body;
+ * detection accepts it, so a not-yet-updated project still reads as installed.
  */
 export declare const LEGACY_WORKFLOW_RULE_FILENAME = "single-sourc-of-truth.md";
 /**
- * The decision rule document, written beside the workflow rule for every
- * configured tool.
- *
- * Deliberately not usable as proof that tospec manages a tool dir: an older
- * tospec wrote this file from init only, so a project can hold an untouched copy
- * left by a version that no longer maintains it. `isToolInstalled` reads
- * WORKFLOW_RULE_FILENAME for that reason.
+ * Written beside the workflow rule, but not proof that tospec manages a tool
+ * dir: an older tospec wrote it from init only, so a project can hold an
+ * untouched copy. `isToolInstalled` reads WORKFLOW_RULE_FILENAME.
  */
 export declare const DECISION_RULE_FILENAME = "decision.md";
 export interface TospecConfig {
@@ -47,36 +34,27 @@ export interface AIToolOption {
     skillsDir?: string;
     detectionPaths?: string[];
     /**
-     * Tool ids this target is built out of. A dependent's skill dirs are links
-     * into its dependency's, so selecting the dependent alone would name links
-     * with no target. Selection expands along this edge instead of the menu
-     * hiding the relationship: every row stays a real, clearable choice, and the
-     * reason a row arrives uninvited is something the user can see.
+     * Tool ids this target is built out of. Selection expands along this edge
+     * instead of the menu hiding the relationship, so every row stays a real,
+     * clearable choice and the reason a row arrives uninvited is visible.
      */
     requires?: string[];
     /**
-     * Used when nothing was selected and nothing was detected. This is not
-     * "always written" — clearing every checkbox writes nothing. It only decides
-     * what a non-interactive run with no information at all falls back to, where
-     * the alternative is producing nothing on first setup.
+     * Used when nothing was selected and nothing was detected. Not "always
+     * written": clearing every checkbox writes nothing. This only decides what a
+     * non-interactive run with no information falls back to.
      */
     fallback?: boolean;
 }
 export declare const AI_TOOLS: AIToolOption[];
 /**
- * Expands a selection along `requires`, dependencies first.
- *
- * Order is part of the contract, not a side effect: the canonical directory has
- * to exist before anything links into it, and callers process the returned list
- * in order. Unknown ids are passed through untouched so the caller's own
- * "unknown tool" error still fires instead of being silently dropped here.
+ * Expands a selection along `requires`, dependencies first. Order is part of the
+ * contract: callers write targets in the returned order, and the canonical
+ * directory must exist before anything is copied from it. Unknown ids pass
+ * through untouched so the caller's own "unknown tool" error still fires.
  *
- * Which is why a cycle throws rather than being absorbed. Returning early on a
- * revisit would still produce a list — one with a dependent ahead of its
- * dependency, since the inner call pushes first — and the caller would then
- * link into a directory nothing had written yet. There is no ordering that
- * satisfies a cycle, so the table is wrong and has to say so at the point the
- * edit is made.
+ * A cycle throws rather than resolving: no ordering satisfies one, so the table
+ * is wrong and has to say so.
  */
 export declare function resolveToolSelection(toolIds: readonly string[]): string[];
 /** Ids at least one other target is built from, so refreshing them fans out. */
@@ -84,11 +62,9 @@ export declare function dependencyToolIds(): string[];
 /** Ids used when a non-interactive run detects nothing and names nothing. */
 export declare function fallbackToolIds(): string[];
 /**
- * The target Codex reads from, which is why it has no row of its own. Named
- * rather than derived: the loading notice is about Codex specifically, and
- * every derived predicate that currently selects this row (dependency, fallback)
- * matches it by coincidence and would drift the notice onto the wrong target
- * the moment another row gained that property.
+ * The target Codex reads from. Named rather than derived: the predicates that
+ * select this row (dependency, fallback) match by coincidence, and would drift
+ * the Codex notice onto the wrong target once another row gained one.
  */
 export declare const CODEX_TARGET_ID = "agents";
 //# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,YAAI,OAAO,EAAE,QAAQ,CAAU,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,QAAQ,EAAE,YAAY,EAQlC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAsBzE;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,YAAI,OAAO,EAAE,QAAQ,CAAU,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,QAAQ,EAAE,YAAY,EAMlC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAsBzE;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC"}

package/dist/core/config.js

@@ -5,60 +5,39 @@ export const TOSPEC_DIR_NAME = 'tospec';
  */
 export const TOOL_RULES_SUBDIR = ['rules', 'tospec'];
 /**
- * The workflow rule document, written for every configured tool by init, update
- * and rules, and removed by none of them.
- *
- * Shared rather than spelled out at each use because it is two things at once:
- * the write target for rules-generation, and the durable proof that tospec
- * currently manages a tool dir (`isToolInstalled`). Specifically this file and
- * not the `rules/tospec/` directory: that directory also holds `decision.md`,
- * which an older tospec wrote from init only — its presence says tospec touched
- * the dir once, not that it manages it now. The two readings only agree while
- * both sides read the name from here.
+ * The workflow rule document: both the write target for rules-generation and the
+ * proof that tospec currently manages a tool dir (`isToolInstalled`). This file,
+ * not the `rules/tospec/` directory, whose other contents only prove tospec
+ * touched the dir once.
  */
 export const WORKFLOW_RULE_FILENAME = 'single-source-of-truth.md';
 /**
- * The same document under its previous, misspelled name (`sourc`).
- *
- * Kept so init/update/rules can retire a copy an older tospec wrote instead of
- * leaving it beside the corrected one, where two rule files with the same body
- * would both be loaded. Detection accepts it too, so a project that has not been
- * updated yet still reads as installed.
+ * The same document under its previous, misspelled name. Kept so init/update can
+ * retire an older copy instead of loading two rule files with the same body;
+ * detection accepts it, so a not-yet-updated project still reads as installed.
  */
 export const LEGACY_WORKFLOW_RULE_FILENAME = 'single-sourc-of-truth.md';
 /**
- * The decision rule document, written beside the workflow rule for every
- * configured tool.
- *
- * Deliberately not usable as proof that tospec manages a tool dir: an older
- * tospec wrote this file from init only, so a project can hold an untouched copy
- * left by a version that no longer maintains it. `isToolInstalled` reads
- * WORKFLOW_RULE_FILENAME for that reason.
+ * Written beside the workflow rule, but not proof that tospec manages a tool
+ * dir: an older tospec wrote it from init only, so a project can hold an
+ * untouched copy. `isToolInstalled` reads WORKFLOW_RULE_FILENAME.
  */
 export const DECISION_RULE_FILENAME = 'decision.md';
 export const AI_TOOLS = [
-    // `.agents` is the directory Codex actually reads skills from, and it holds
-    // the canonical copy every other target links into.
-    //
-    // Codex is deliberately absent as a row of its own: it reads skills from
-    // `.agents`, so a `.codex` target was a second copy nothing ever loaded.
+    // `.agents` holds the canonical copy every other target is built from, and is
+    // where Codex reads skills, so Codex has no row of its own: a `.codex` target
+    // would be a second copy nothing loads.
     { name: 'Agents', value: 'agents', available: true, successLabel: 'Agents', skillsDir: '.agents', fallback: true },
     { name: 'Claude Code', value: 'claude', available: true, successLabel: 'Claude Code', skillsDir: '.claude', requires: ['agents'] }
 ];
 /**
- * Expands a selection along `requires`, dependencies first.
- *
- * Order is part of the contract, not a side effect: the canonical directory has
- * to exist before anything links into it, and callers process the returned list
- * in order. Unknown ids are passed through untouched so the caller's own
- * "unknown tool" error still fires instead of being silently dropped here.
+ * Expands a selection along `requires`, dependencies first. Order is part of the
+ * contract: callers write targets in the returned order, and the canonical
+ * directory must exist before anything is copied from it. Unknown ids pass
+ * through untouched so the caller's own "unknown tool" error still fires.
  *
- * Which is why a cycle throws rather than being absorbed. Returning early on a
- * revisit would still produce a list — one with a dependent ahead of its
- * dependency, since the inner call pushes first — and the caller would then
- * link into a directory nothing had written yet. There is no ordering that
- * satisfies a cycle, so the table is wrong and has to say so at the point the
- * edit is made.
+ * A cycle throws rather than resolving: no ordering satisfies one, so the table
+ * is wrong and has to say so.
  */
 export function resolveToolSelection(toolIds) {
     const resolved = [];
@@ -90,11 +69,9 @@ export function fallbackToolIds() {
     return AI_TOOLS.filter((tool) => tool.fallback && tool.skillsDir).map((tool) => tool.value);
 }
 /**
- * The target Codex reads from, which is why it has no row of its own. Named
- * rather than derived: the loading notice is about Codex specifically, and
- * every derived predicate that currently selects this row (dependency, fallback)
- * matches it by coincidence and would drift the notice onto the wrong target
- * the moment another row gained that property.
+ * The target Codex reads from. Named rather than derived: the predicates that
+ * select this row (dependency, fallback) match by coincidence, and would drift
+ * the Codex notice onto the wrong target once another row gained one.
  */
 export const CODEX_TARGET_ID = 'agents';
 //# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAU,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AA8BpD,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACtC,4EAA4E;IAC5E,oDAAoD;IACpD,EAAE;IACF,yEAAyE;IACzE,yEAAyE;IACzE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClH,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;CACnI,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAQ,EAAE;QACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO;QAClC,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,4CAA4C,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;gBACpF,sFAAsF,CACzF,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;YACpF,KAAK,CAAC,UAAU,CAAC,CAAC;QACpB,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,OAAO;QAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAU,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAExE;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AA2BpD,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACtC,8EAA8E;IAC9E,8EAA8E;IAC9E,wCAAwC;IACxC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClH,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;CACnI,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAQ,EAAE;QACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO;QAClC,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,4CAA4C,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;gBACpF,sFAAsF,CACzF,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;YACpF,KAAK,CAAC,UAAU,CAAC,CAAC;QACpB,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,OAAO;QAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC"}

package/dist/core/dashboard-activity.d.ts

@@ -1,10 +1,9 @@
 /**
  * Dashboard git activity + health signals (ADR 001, D4-D7, D12, D16).
  *
- * Two `git log` runs produce a 30-day daily series: commits repo-wide vs
- * commits touching `tospec/`. The gap between the two is the spec-drift
- * signal. Pure aggregation is split from the git-spawning wrapper so vitest
- * can exercise it without a repo.
+ * Two `git log` runs produce a 30-day daily series: commits repo-wide vs commits
+ * touching `tospec/`. The gap between the two is the spec-drift signal. Pure
+ * aggregation is split from the git-spawning wrapper so tests need no repo.
  */
 export declare const DEFAULT_STALE_DAYS = 14;
 /** Series window: trailing day count, or 'all' for the full git history. */
@@ -40,11 +39,10 @@ export declare function historySpanDays(repoDates: string[], tospecDates: string
 /** Stale-change threshold from tospec/config.yaml, defaulting to 14 days. */
 export declare function resolveStaleDays(projectRoot: string): number;
 /**
- * Collects the activity payload. `changeName` narrows the tospec series to
- * that change's directory (detail view); the repo series stays repo-wide.
- * `window` is the trailing day count (default 30) or 'all' for full history.
- * Git being unavailable degrades to `{available: false}` (D6) — staleDays is
- * config, not git, so it is always populated.
+ * The activity payload. `changeName` narrows the tospec series to that change's
+ * directory; the repo series stays repo-wide. `window` is the trailing day count
+ * (default 30) or 'all'. Git being unavailable degrades to `{available: false}`
+ * (D6) — staleDays comes from config, so it is always populated.
  */
 export declare function collectActivity(projectRoot: string, changeName?: string, window?: ActivityWindow): Promise<DashboardActivity>;
 //# sourceMappingURL=dashboard-activity.d.ts.map

package/dist/core/dashboard-activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-activity.d.ts","sourceRoot":"","sources":["../../src/core/dashboard-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAIrC,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,GAAE,MAAsB,EAC5B,KAAK,GAAE,IAAiB,GACvB,WAAW,EAAE,CAaf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EAAE,EACnB,iBAAiB,EAAE,MAAM,EACzB,UAAU,GAAE,MAA0B,GACrC,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,MAAsB,EAC/B,KAAK,GAAE,IAAiB,GACvB,MAAM,CAWR;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAM5D;AAgCD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,GAAE,cAA8B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAgC5B"}
+{"version":3,"file":"dashboard-activity.d.ts","sourceRoot":"","sources":["../../src/core/dashboard-activity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAIrC,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,GAAE,MAAsB,EAC5B,KAAK,GAAE,IAAiB,GACvB,WAAW,EAAE,CAaf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EAAE,EACnB,iBAAiB,EAAE,MAAM,EACzB,UAAU,GAAE,MAA0B,GACrC,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,MAAsB,EAC/B,KAAK,GAAE,IAAiB,GACvB,MAAM,CAWR;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAM5D;AAsCD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,GAAE,cAA8B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CA+B5B"}

package/dist/core/dashboard-activity.js

@@ -1,10 +1,9 @@
 /**
  * Dashboard git activity + health signals (ADR 001, D4-D7, D12, D16).
  *
- * Two `git log` runs produce a 30-day daily series: commits repo-wide vs
- * commits touching `tospec/`. The gap between the two is the spec-drift
- * signal. Pure aggregation is split from the git-spawning wrapper so vitest
- * can exercise it without a repo.
+ * Two `git log` runs produce a 30-day daily series: commits repo-wide vs commits
+ * touching `tospec/`. The gap between the two is the spec-drift signal. Pure
+ * aggregation is split from the git-spawning wrapper so tests need no repo.
  */
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
@@ -15,9 +14,6 @@ const execFileAsync = promisify(execFile);
 export const DEFAULT_STALE_DAYS = 14;
 const ACTIVITY_DAYS = 30;
 const DRIFT_WINDOW_DAYS = 7;
-// -----------------------------------------------------------------------------
-// Pure aggregation (unit-testable)
-// -----------------------------------------------------------------------------
 /**
  * Buckets two lists of commit dates (yyyy-mm-dd, from `git log --date=short`)
  * into a zero-filled daily series covering the last `days` days ending `today`.
@@ -77,9 +73,6 @@ export function resolveStaleDays(projectRoot) {
         return DEFAULT_STALE_DAYS;
     }
 }
-// -----------------------------------------------------------------------------
-// Git wrapper
-// -----------------------------------------------------------------------------
 /** Commit dates (yyyy-mm-dd, one per commit), newest first. */
 async function gitLogDates(projectRoot, window, pathFilters) {
     const args = ['log', '--format=%cd', '--date=short'];
@@ -87,8 +80,8 @@ async function gitLogDates(projectRoot, window, pathFilters) {
         args.splice(1, 0, `--since=${window} days ago`);
     if (pathFilters)
         args.push('--', ...pathFilters);
-    // windowsHide: git is a console app; without this each call flashes a window
-    // on Windows — and the dashboard runs several per activity refresh.
+    // windowsHide: git is a console app, and the dashboard runs several of these
+    // per activity refresh — each would flash a window on Windows.
     const { stdout } = await execFileAsync('git', args, { cwd: projectRoot, windowsHide: true });
     return stdout.split(/\r?\n/).filter((line) => /^\d{4}-\d{2}-\d{2}$/.test(line));
 }
@@ -96,19 +89,29 @@ async function gitLogDates(projectRoot, window, pathFilters) {
 async function gitUnavailableReason(projectRoot) {
     try {
         await execFileAsync('git', ['rev-parse', '--is-inside-work-tree'], { cwd: projectRoot, windowsHide: true });
-        return null;
     }
     catch (err) {
         const code = err.code;
         return code === 'ENOENT' ? 'git not found' : 'not a git repository';
     }
+    // A freshly `git init`ed repo passes the work-tree check but has no HEAD, and
+    // `git log` there exits non-zero ("does not have any commits yet") — which
+    // surfaced as a 500 from /api/activity on exactly the project a first-time
+    // dashboard user has. Unborn HEAD is the same "nothing to chart" case as no
+    // repo at all, so it degrades the same way.
+    try {
+        await execFileAsync('git', ['rev-parse', '--verify', '--quiet', 'HEAD'], { cwd: projectRoot, windowsHide: true });
+        return null;
+    }
+    catch {
+        return 'no commits yet';
+    }
 }
 /**
- * Collects the activity payload. `changeName` narrows the tospec series to
- * that change's directory (detail view); the repo series stays repo-wide.
- * `window` is the trailing day count (default 30) or 'all' for full history.
- * Git being unavailable degrades to `{available: false}` (D6) — staleDays is
- * config, not git, so it is always populated.
+ * The activity payload. `changeName` narrows the tospec series to that change's
+ * directory; the repo series stays repo-wide. `window` is the trailing day count
+ * (default 30) or 'all'. Git being unavailable degrades to `{available: false}`
+ * (D6) — staleDays comes from config, so it is always populated.
  */
 export async function collectActivity(projectRoot, changeName, window = ACTIVITY_DAYS) {
     const staleDays = resolveStaleDays(projectRoot);
@@ -117,10 +120,9 @@ export async function collectActivity(projectRoot, changeName, window = ACTIVITY
         return { available: false, reason, days: [], specDrift: false, staleDays };
     }
     // `tospec migrate` copies openspec/ into tospec/, so commit history for
-    // migrated changes lives under openspec/ paths. A pathspec that matches
-    // nothing is harmless, so always include the legacy prefix.
-    // Limitation: only covers the default `openspec` source dir; record custom
-    // migrate source dirs in config if anyone needs them counted.
+    // migrated changes lives under openspec/ paths. A pathspec matching nothing
+    // is harmless, so the legacy prefix is always included.
+    // Limitation: only the default `openspec` source dir.
     const pathFilters = changeName
         ? [`tospec/changes/${changeName}/`, `openspec/changes/${changeName}/`]
         : ['tospec/', 'openspec/'];
@@ -128,8 +130,8 @@ export async function collectActivity(projectRoot, changeName, window = ACTIVITY
         gitLogDates(projectRoot, window),
         gitLogDates(projectRoot, window, pathFilters),
     ]);
-    // Limitation: 'all' zero-fills one entry per day since the first commit; a
-    // decade-old repo means a few thousand points, coarser buckets if that hurts.
+    // Limitation: 'all' zero-fills one entry per day since the first commit, so a
+    // decade-old repo yields a few thousand points.
     const spanDays = window === 'all' ? historySpanDays(repoDates, tospecDates) : window;
     const days = aggregateDaily(repoDates, tospecDates, spanDays);
     // Drift only makes sense repo-wide, not for a single change's series.