@stackbilt/cli 0.4.1 → 0.5.0

package/README.md

@@ -68,6 +68,7 @@ charter adf bundle --task "fix React component"
 charter adf migrate --dry-run  # preview agent config → ADF migration
 charter adf sync --check     # verify .adf files match locked hashes
 charter adf evidence --auto-measure --format json  # validate metric ceilings
+charter telemetry report --period 24h --format json  # passive local usage summary
 ```
 
 ## Human Onboarding (Copy/Paste)
@@ -138,6 +139,7 @@ npx charter audit --format json
 npx charter adf migrate --dry-run --format json
 npx charter adf evidence --auto-measure --format json --ci
 npx charter adf sync --check --format json
+npx charter telemetry report --period 24h --format json
 
 # recurring maintenance
 npx charter doctor --format json
@@ -177,7 +179,7 @@ charter setup --preset fullstack --ci github --yes
 ```
 
 Detection output includes `detected.sources` in JSON mode so agents can verify which manifests were scanned before applying a baseline.
-Setup also adds optional root scripts when missing: `charter:detect` and `charter:setup`.
+Setup also adds optional root scripts when missing: `charter:detect`, `charter:setup`, `verify:adf`, `charter:doctor`, and `charter:adf:bundle`.
 Setup JSON now includes `mutationPlan` and `appliedMutations` so side effects are explicit before/after apply.
 Setup baseline mutation metadata now includes `configHashBefore`, `configHashAfter`, and `writesPerformed`.
 
@@ -188,6 +190,7 @@ Scaffold `.charter/` config templates only. Supports `--preset worker|frontend|b
 ### `charter doctor`
 
 Validate CLI installation, `.charter/` config, and ADF readiness (manifest existence, module parseability, sync lock status).
+Use `charter doctor --adf-only --ci` for strict ADF wiring gates in automation.
 
 ### `charter validate`
 
@@ -261,7 +264,7 @@ charter hook install --pre-commit
 ```
 
 - `--commit-msg`: Install a commit-msg hook that normalizes `Governed-By` and `Resolves-Request` trailers using `git interpret-trailers`.
-- `--pre-commit`: Install a pre-commit hook that runs `charter adf evidence --auto-measure --ci` before each commit. Only gates when `.ai/manifest.adf` exists — no-op otherwise. Uses `npx charter` so consuming repos need Charter as a devDependency.
+- `--pre-commit`: Install a pre-commit hook that enforces ADF routing with `charter doctor --adf-only --ci` and validates ceilings with `charter adf evidence --auto-measure --ci` (or `pnpm run verify:adf` when that script exists). Only gates when `.ai/manifest.adf` exists — no-op otherwise.
 - `--force` (or global `--yes`) allows overwrite when a non-Charter hook already exists.
 - Both flags can be passed together to install both hooks in one command.
 
@@ -273,24 +276,41 @@ ADF (Attention-Directed Format) context management. Replaces monolithic `.cursor
 charter adf init [--ai-dir <dir>] [--force]
 charter adf fmt <file> [--check] [--write]
 charter adf patch <file> --ops '<json>' | --ops-file <path>
+charter adf create <module> [--triggers "a,b,c"] [--load default|on-demand] [--ai-dir <dir>] [--force]
 charter adf bundle --task "Fix React component" [--ai-dir <dir>]
 charter adf sync --check [--ai-dir <dir>]
 charter adf sync --write [--ai-dir <dir>]
 charter adf evidence [--task "<prompt>"] [--ai-dir <dir>] [--auto-measure]
                      [--context '{"key": value}'] [--context-file <path>]
+charter adf metrics recalibrate [--headroom <percent>] [--reason "<text>"|--auto-rationale] [--dry-run]
 charter adf migrate [--dry-run] [--source <file>] [--no-backup]
                     [--merge-strategy append|dedupe|replace] [--ai-dir <dir>]
 ```
 
-- `init`: Scaffold `.ai/` with `manifest.adf`, `core.adf`, and `state.adf`. Core module includes a 500-line LOC guardrail metric by default.
+- `init`: Scaffold `.ai/` with `manifest.adf`, `core.adf`, `state.adf`, and starter `frontend.adf`/`backend.adf` on-demand module stubs. Core module includes a 500-line LOC guardrail metric by default.
 - `fmt`: Parse and reformat to canonical ADF. `--check` exits 1 if not canonical. `--write` reformats in place. Default prints to stdout.
+- `fmt --explain`: Print canonical section ordering used by the formatter.
 - `patch`: Apply typed delta operations (ADD_BULLET, REPLACE_BULLET, REMOVE_BULLET, ADD_SECTION, REPLACE_SECTION, REMOVE_SECTION, UPDATE_METRIC). Accepts `--ops <json>` inline or `--ops-file <path>` from a file.
-- `bundle`: Read `manifest.adf`, resolve ON_DEMAND modules via keyword matching against the task, and output merged context with token estimate, trigger observability (matched keywords, load reasons), unmatched modules, and advisory-only warnings.
+- `create`: Create an ADF module file and register it in `manifest.adf` under `DEFAULT_LOAD` or `ON_DEMAND` in one command.
+- `bundle`: Read `manifest.adf`, resolve ON_DEMAND modules via keyword matching against the task, and output merged context with token estimate, trigger observability (matched keywords, load reasons), unmatched modules, and advisory-only warnings. Missing ON_DEMAND files are warnings in output (`missingModules` in JSON), while missing DEFAULT_LOAD files still fail.
 - `sync --check`: Verify source `.adf` files match their locked hashes. Exits 1 if any source has drifted since last sync.
 - `sync --write`: Update `.adf.lock` with current source hashes.
-- `evidence`: Validate all metric ceilings in the merged document and produce a structured pass/fail evidence report. `--auto-measure` counts lines in files referenced by the manifest METRICS section. `--context` or `--context-file` inject external metric overrides that take precedence over auto-measured and document values. In `--ci` mode, exits 1 on constraint failures (warnings don't fail). The governance workflow template runs this automatically on PRs when `.ai/manifest.adf` is present.
+- `evidence`: Validate all metric ceilings in the merged document and produce a structured pass/fail evidence report. `--auto-measure` counts lines in files referenced by the manifest METRICS section. `--context` or `--context-file` inject external metric overrides that take precedence over auto-measured and document values. In `--ci` mode, exits 1 on constraint failures (warnings don't fail). Also reports stale-baseline warnings (baseline vs current delta + recommended ceiling) when baseline values drift significantly. The governance workflow template runs this automatically on PRs when `.ai/manifest.adf` is present.
+- `metrics recalibrate`: Re-measure current LOC from manifest metric sources, propose and apply new ceilings using configurable headroom, and append rationale records to `BUDGET_RATIONALES`. Requires explicit rationale (`--reason`) unless `--auto-rationale` is used.
 - `migrate`: Scan existing agent config files (CLAUDE.md, .cursorrules, agents.md, GEMINI.md, copilot-instructions.md), classify content using the ADX-002 decision tree, and migrate into ADF modules. `--dry-run` previews the migration plan without writing files. `--source <file>` targets a single file. `--no-backup` skips `.pre-adf-migrate.bak` creation. `--merge-strategy` controls deduplication: `dedupe` (default, skip items already in ADF), `append` (always add), or `replace`. Environment-specific rules (WSL, PATH, credential helpers) are retained in the thin pointer.
 
+### `charter telemetry`
+
+Passive local observability for Charter/ADF usage. Every CLI run appends command metadata (timestamp, command path, flags, duration, exit code) to `.charter/telemetry/events.ndjson`.
+
+```bash
+charter telemetry report --period 24h
+charter telemetry report --period 7d --format json
+```
+
+- `report`: aggregates events over a time window (`--period` supports `s|m|h|d`, for example `30m`, `24h`, `7d`).
+- Privacy: command metadata only. No prompt body, source code, or file contents are captured.
+
 #### Evidence Example (from Charter's own repo)
 
 Charter uses its own ADF system for self-governance. Running evidence with auto-measurement:

package/dist/__tests__/adf-metrics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adf-metrics.test.d.ts.map

package/dist/__tests__/adf-metrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf-metrics.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/adf-metrics.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/adf-metrics.test.js

@@ -0,0 +1,117 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const vitest_1 = require("vitest");
+const adf_metrics_1 = require("../commands/adf-metrics");
+const adf_evidence_1 = require("../commands/adf-evidence");
+const baseOptions = {
+    configPath: '.charter',
+    format: 'json',
+    ciMode: false,
+    yes: false,
+};
+const originalCwd = process.cwd();
+const tempDirs = [];
+(0, vitest_1.afterEach)(() => {
+    process.chdir(originalCwd);
+    while (tempDirs.length > 0) {
+        const dir = tempDirs.pop();
+        if (dir) {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    }
+    vitest_1.vi.restoreAllMocks();
+});
+function writeFixtureRepo(tmp, baseline = 100) {
+    fs.mkdirSync(path.join(tmp, '.ai'), { recursive: true });
+    fs.mkdirSync(path.join(tmp, 'src'), { recursive: true });
+    fs.writeFileSync(path.join(tmp, '.ai', 'manifest.adf'), `ADF: 0.1
+DEFAULT_LOAD:
+  - core.adf
+  - state.adf
+
+METRICS:
+  COMPONENTS_TOTAL_LOC: src/components.ts
+`);
+    fs.writeFileSync(path.join(tmp, '.ai', 'core.adf'), `ADF: 0.1
+METRICS:
+  components_total_loc: ${baseline} / 120 [lines]
+`);
+    fs.writeFileSync(path.join(tmp, '.ai', 'state.adf'), 'ADF: 0.1\nSTATE:\n  CURRENT: testing\n');
+    fs.writeFileSync(path.join(tmp, 'src', 'components.ts'), Array.from({ length: 200 }, (_, i) => `line_${i}`).join('\n') + '\n');
+}
+(0, vitest_1.describe)('adf metrics recalibrate', () => {
+    (0, vitest_1.it)('requires rationale by default', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'charter-metrics-test-'));
+        tempDirs.push(tmp);
+        process.chdir(tmp);
+        writeFixtureRepo(tmp);
+        (0, vitest_1.expect)(() => (0, adf_metrics_1.adfMetricsCommand)(baseOptions, ['recalibrate'])).toThrow('requires --reason');
+    });
+    (0, vitest_1.it)('recalibrates metric ceilings and writes rationale entries', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'charter-metrics-test-'));
+        tempDirs.push(tmp);
+        process.chdir(tmp);
+        writeFixtureRepo(tmp);
+        const exitCode = (0, adf_metrics_1.adfMetricsCommand)(baseOptions, ['recalibrate', '--headroom', '20', '--reason', 'Scope expanded with new built views']);
+        (0, vitest_1.expect)(exitCode).toBe(0);
+        const measured = fs.readFileSync(path.join(tmp, 'src', 'components.ts'), 'utf-8').split('\n').length;
+        const ceiling = Math.ceil(measured * 1.2);
+        const core = fs.readFileSync(path.join(tmp, '.ai', 'core.adf'), 'utf-8');
+        (0, vitest_1.expect)(core).toContain(`components_total_loc: ${measured} / ${ceiling} [lines]`);
+        (0, vitest_1.expect)(core).toContain('BUDGET_RATIONALES');
+        (0, vitest_1.expect)(core).toContain('Scope expanded with new built views');
+    });
+});
+(0, vitest_1.describe)('adf evidence stale baseline warnings', () => {
+    (0, vitest_1.it)('emits staleBaselines when measured value greatly exceeds baseline value', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'charter-evidence-test-'));
+        tempDirs.push(tmp);
+        process.chdir(tmp);
+        writeFixtureRepo(tmp, 80);
+        const logs = [];
+        vitest_1.vi.spyOn(console, 'log').mockImplementation((msg) => logs.push(msg));
+        const exitCode = (0, adf_evidence_1.adfEvidence)(baseOptions, ['--ai-dir', '.ai', '--auto-measure']);
+        (0, vitest_1.expect)(exitCode).toBe(0);
+        const out = JSON.parse(logs[0]);
+        (0, vitest_1.expect)(out.staleBaselines?.length).toBeGreaterThan(0);
+        (0, vitest_1.expect)(out.staleBaselines?.[0].metric).toBe('components_total_loc');
+        (0, vitest_1.expect)(out.staleBaselines?.[0].rationaleRequired).toBe(true);
+    });
+});
+//# sourceMappingURL=adf-metrics.test.js.map

package/dist/__tests__/adf-metrics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf-metrics.test.js","sourceRoot":"","sources":["../../src/__tests__/adf-metrics.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA8B;AAC9B,4CAA8B;AAC9B,gDAAkC;AAClC,mCAA6D;AAE7D,yDAA4D;AAC5D,2DAAuD;AAEvD,MAAM,WAAW,GAAe;IAC9B,UAAU,EAAE,UAAU;IACtB,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,KAAK;IACb,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;AAE9B,IAAA,kBAAS,EAAC,GAAG,EAAE;IACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3B,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,GAAG,EAAE,CAAC;YACR,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,WAAE,CAAC,eAAe,EAAE,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,SAAS,gBAAgB,CAAC,GAAW,EAAE,QAAQ,GAAG,GAAG;IACnD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,EAAE;;;;;;;CAOzD,CAAC,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE;;0BAE5B,QAAQ;CACjC,CAAC,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,wCAAwC,CAAC,CAAC;IAC/F,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AACjI,CAAC;AAED,IAAA,iBAAQ,EAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAA,WAAE,EAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;QAC5E,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEtB,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,+BAAiB,EAAC,WAAW,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;QAC5E,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEtB,MAAM,QAAQ,GAAG,IAAA,+BAAiB,EAAC,WAAW,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,qCAAqC,CAAC,CAAC,CAAC;QACxI,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzB,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACrG,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;QACzE,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,yBAAyB,QAAQ,MAAM,OAAO,UAAU,CAAC,CAAC;QACjF,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC5C,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,IAAA,WAAE,EAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;QAC7E,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,gBAAgB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAE1B,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,WAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,MAAM,QAAQ,GAAG,IAAA,0BAAW,EAAC,WAAW,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACjF,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAA+E,CAAC;QAC9G,IAAA,eAAM,EAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACtD,IAAA,eAAM,EAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACpE,IAAA,eAAM,EAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/git-helpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-helpers.test.d.ts.map

package/dist/__tests__/git-helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-helpers.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/git-helpers.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/git-helpers.test.js

@@ -0,0 +1,136 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const git_helpers_1 = require("../git-helpers");
+(0, vitest_1.describe)('git-helpers', () => {
+    let originalCwd;
+    let tempDir;
+    (0, vitest_1.beforeEach)(() => {
+        originalCwd = process.cwd();
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'charter-git-helpers-'));
+        process.chdir(tempDir);
+    });
+    (0, vitest_1.afterEach)(() => {
+        process.chdir(originalCwd);
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    (0, vitest_1.describe)('runGit', () => {
+        (0, vitest_1.it)('succeeds inside a git repo', () => {
+            (0, node_child_process_1.execFileSync)('git', ['init'], { stdio: 'ignore' });
+            const result = (0, git_helpers_1.runGit)(['rev-parse', '--is-inside-work-tree']).trim();
+            (0, vitest_1.expect)(result).toBe('true');
+        });
+        (0, vitest_1.it)('throws outside a git repo', () => {
+            (0, vitest_1.expect)(() => (0, git_helpers_1.runGit)(['rev-parse', '--is-inside-work-tree'])).toThrow();
+        });
+    });
+    (0, vitest_1.describe)('isGitRepo', () => {
+        (0, vitest_1.it)('returns true inside a git repo', () => {
+            (0, node_child_process_1.execFileSync)('git', ['init'], { stdio: 'ignore' });
+            (0, vitest_1.expect)((0, git_helpers_1.isGitRepo)()).toBe(true);
+        });
+        (0, vitest_1.it)('returns false outside a git repo', () => {
+            (0, vitest_1.expect)((0, git_helpers_1.isGitRepo)()).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('hasCommits', () => {
+        (0, vitest_1.it)('returns false on empty repo', () => {
+            (0, node_child_process_1.execFileSync)('git', ['init'], { stdio: 'ignore' });
+            (0, vitest_1.expect)((0, git_helpers_1.hasCommits)()).toBe(false);
+        });
+        (0, vitest_1.it)('returns true after a commit', () => {
+            (0, node_child_process_1.execFileSync)('git', ['init'], { stdio: 'ignore' });
+            (0, node_child_process_1.execFileSync)('git', ['config', 'user.email', 'test@test.com'], { stdio: 'ignore' });
+            (0, node_child_process_1.execFileSync)('git', ['config', 'user.name', 'Test'], { stdio: 'ignore' });
+            fs.writeFileSync(path.join(tempDir, 'file.txt'), 'hello');
+            (0, node_child_process_1.execFileSync)('git', ['add', '.'], { stdio: 'ignore' });
+            (0, node_child_process_1.execFileSync)('git', ['commit', '-m', 'init'], { stdio: 'ignore' });
+            (0, vitest_1.expect)((0, git_helpers_1.hasCommits)()).toBe(true);
+        });
+    });
+    (0, vitest_1.describe)('getGitErrorMessage', () => {
+        (0, vitest_1.it)('extracts stderr from exec error', () => {
+            const err = Object.assign(new Error('fail'), { stderr: 'fatal: not a repo' });
+            (0, vitest_1.expect)((0, git_helpers_1.getGitErrorMessage)(err)).toBe('fatal: not a repo');
+        });
+        (0, vitest_1.it)('falls back to message', () => {
+            (0, vitest_1.expect)((0, git_helpers_1.getGitErrorMessage)(new Error('some error'))).toBe('some error');
+        });
+        (0, vitest_1.it)('returns fallback for non-Error', () => {
+            (0, vitest_1.expect)((0, git_helpers_1.getGitErrorMessage)('string')).toBe('Unknown git error.');
+        });
+    });
+    (0, vitest_1.describe)('parseCommitMetadata', () => {
+        (0, vitest_1.it)('parses git log format', () => {
+            const log = 'abc123\x1fAlice\x1f2026-01-01T00:00:00Z\x1fInitial commit\x1e';
+            const result = (0, git_helpers_1.parseCommitMetadata)(log);
+            (0, vitest_1.expect)(result).toHaveLength(1);
+            (0, vitest_1.expect)(result[0].sha).toBe('abc123');
+            (0, vitest_1.expect)(result[0].author).toBe('Alice');
+            (0, vitest_1.expect)(result[0].message).toBe('Initial commit');
+        });
+        (0, vitest_1.it)('handles multiple commits', () => {
+            const log = 'aaa\x1fA\x1f2026-01-01\x1fFirst\x1ebbb\x1fB\x1f2026-01-02\x1fSecond\x1e';
+            (0, vitest_1.expect)((0, git_helpers_1.parseCommitMetadata)(log)).toHaveLength(2);
+        });
+    });
+    (0, vitest_1.describe)('parseChangedFilesByCommit', () => {
+        (0, vitest_1.it)('parses name-only log', () => {
+            const log = [
+                'a'.repeat(40),
+                'src/index.ts',
+                'src/util.ts',
+                '',
+                'b'.repeat(40),
+                'README.md',
+            ].join('\n');
+            const result = (0, git_helpers_1.parseChangedFilesByCommit)(log);
+            (0, vitest_1.expect)(result.get('a'.repeat(40))).toEqual(['src/index.ts', 'src/util.ts']);
+            (0, vitest_1.expect)(result.get('b'.repeat(40))).toEqual(['README.md']);
+        });
+    });
+    (0, vitest_1.describe)('getRecentCommitRange', () => {
+        (0, vitest_1.it)('returns HEAD on empty repo', () => {
+            (0, node_child_process_1.execFileSync)('git', ['init'], { stdio: 'ignore' });
+            (0, vitest_1.expect)((0, git_helpers_1.getRecentCommitRange)()).toBe('HEAD');
+        });
+    });
+});
+//# sourceMappingURL=git-helpers.test.js.map

package/dist/__tests__/git-helpers.test.js.map

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

package/dist/__tests__/setup.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup.test.d.ts.map

package/dist/__tests__/setup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/setup.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/setup.test.js

@@ -0,0 +1,74 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const vitest_1 = require("vitest");
+const setup_1 = require("../commands/setup");
+const originalCwd = process.cwd();
+const tempDirs = [];
+(0, vitest_1.afterEach)(() => {
+    process.chdir(originalCwd);
+    while (tempDirs.length > 0) {
+        const dir = tempDirs.pop();
+        if (dir) {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    }
+});
+(0, vitest_1.describe)('syncPackageManifest', () => {
+    (0, vitest_1.it)('adds ongoing governance scripts during setup sync', () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'charter-setup-test-'));
+        tempDirs.push(tmp);
+        process.chdir(tmp);
+        fs.writeFileSync('package.json', JSON.stringify({ name: 'tmp', version: '1.0.0' }, null, 2));
+        (0, setup_1.syncPackageManifest)('worker', true, true);
+        const pkg = JSON.parse(fs.readFileSync('package.json', 'utf-8'));
+        (0, vitest_1.expect)(pkg.scripts?.['charter:detect']).toBe('charter setup --detect-only --format json');
+        (0, vitest_1.expect)(pkg.scripts?.['charter:setup']).toBe('charter setup --preset worker --ci github --yes');
+        (0, vitest_1.expect)(pkg.scripts?.['verify:adf']).toBe('charter doctor --adf-only --ci --format json && charter adf evidence --auto-measure --ci --format json');
+        (0, vitest_1.expect)(pkg.scripts?.['charter:doctor']).toBe('charter doctor --format json');
+        (0, vitest_1.expect)(pkg.scripts?.['charter:adf:bundle']).toBe('charter adf bundle --task "describe task" --format json');
+    });
+    (0, vitest_1.it)('github workflow template enforces ADF routing checks', () => {
+        const workflow = (0, setup_1.getGithubWorkflow)('pnpm');
+        (0, vitest_1.expect)(workflow).toContain('ADF Wiring & Pointer Integrity');
+        (0, vitest_1.expect)(workflow).toContain('npx charter doctor --adf-only --ci --format text');
+        (0, vitest_1.expect)(workflow).toContain('ADF Evidence');
+        (0, vitest_1.expect)(workflow).toContain('npx charter adf evidence --auto-measure --ci --format text');
+    });
+});
+//# sourceMappingURL=setup.test.js.map

package/dist/__tests__/setup.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.test.js","sourceRoot":"","sources":["../../src/__tests__/setup.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA8B;AAC9B,4CAA8B;AAC9B,gDAAkC;AAClC,mCAAyD;AACzD,6CAA2E;AAE3E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;AAE9B,IAAA,kBAAS,EAAC,GAAG,EAAE;IACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3B,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,GAAG,EAAE,CAAC;YACR,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,IAAA,WAAE,EAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC,CAAC;QAC1E,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEnB,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE7F,IAAA,2BAAmB,EAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAE1C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAyC,CAAC;QACzG,IAAA,eAAM,EAAC,GAAG,CAAC,OAAO,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC1F,IAAA,eAAM,EAAC,GAAG,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAC/F,IAAA,eAAM,EAAC,GAAG,CAAC,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,wGAAwG,CAAC,CAAC;QACnJ,IAAA,eAAM,EAAC,GAAG,CAAC,OAAO,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC7E,IAAA,eAAM,EAAC,GAAG,CAAC,OAAO,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAC9G,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,QAAQ,GAAG,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;QAC3C,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QAC7D,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,kDAAkD,CAAC,CAAC;QAC/E,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC3C,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,4DAA4D,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/telemetry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry.test.d.ts.map

package/dist/__tests__/telemetry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/telemetry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/telemetry.test.js

@@ -0,0 +1,119 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const vitest_1 = require("vitest");
+const index_1 = require("../index");
+const telemetry_1 = require("../commands/telemetry");
+const originalCwd = process.cwd();
+const tempDirs = [];
+(0, vitest_1.afterEach)(() => {
+    process.chdir(originalCwd);
+    while (tempDirs.length > 0) {
+        const dir = tempDirs.pop();
+        if (dir) {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    }
+    vitest_1.vi.restoreAllMocks();
+});
+(0, vitest_1.describe)('telemetry', () => {
+    (0, vitest_1.it)('records local telemetry events during command execution', async () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'charter-telemetry-test-'));
+        tempDirs.push(tmp);
+        process.chdir(tmp);
+        vitest_1.vi.spyOn(console, 'log').mockImplementation(() => { });
+        const exitCode = await (0, index_1.run)(['classify', 'update', 'readme', '--format', 'json', '--config', '.charter']);
+        (0, vitest_1.expect)(exitCode).toBe(0);
+        const telemetryFile = path.join(tmp, '.charter', 'telemetry', 'events.ndjson');
+        (0, vitest_1.expect)(fs.existsSync(telemetryFile)).toBe(true);
+        const lines = fs.readFileSync(telemetryFile, 'utf-8').trim().split('\n');
+        const event = JSON.parse(lines[lines.length - 1]);
+        (0, vitest_1.expect)(event.commandPath).toBe('classify');
+        (0, vitest_1.expect)(event.exitCode).toBe(0);
+        (0, vitest_1.expect)(event.flags).toContain('--format');
+        (0, vitest_1.expect)(event.flags).toContain('--config');
+    });
+    (0, vitest_1.it)('generates telemetry report from local event log', async () => {
+        const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'charter-telemetry-report-'));
+        tempDirs.push(tmp);
+        process.chdir(tmp);
+        const telemetryDir = path.join(tmp, '.charter', 'telemetry');
+        fs.mkdirSync(telemetryDir, { recursive: true });
+        const now = Date.now();
+        const events = [
+            {
+                version: 1,
+                timestamp: new Date(now - 60_000).toISOString(),
+                commandPath: 'adf.bundle',
+                flags: ['--task'],
+                format: 'json',
+                ciMode: false,
+                durationMs: 120,
+                exitCode: 0,
+                success: true,
+            },
+            {
+                version: 1,
+                timestamp: new Date(now - 30_000).toISOString(),
+                commandPath: 'doctor',
+                flags: ['--ci'],
+                format: 'json',
+                ciMode: true,
+                durationMs: 90,
+                exitCode: 1,
+                success: false,
+            },
+        ];
+        fs.writeFileSync(path.join(telemetryDir, 'events.ndjson'), events.map((e) => JSON.stringify(e)).join('\n') + '\n');
+        const logs = [];
+        vitest_1.vi.spyOn(console, 'log').mockImplementation((msg) => logs.push(msg));
+        const options = {
+            configPath: '.charter',
+            format: 'json',
+            ciMode: false,
+            yes: false,
+        };
+        const exitCode = await (0, telemetry_1.telemetryCommand)(options, ['report', '--period', '24h']);
+        (0, vitest_1.expect)(exitCode).toBe(0);
+        const report = JSON.parse(logs[0]);
+        (0, vitest_1.expect)(report.totalEvents).toBe(2);
+        (0, vitest_1.expect)(report.failureCount).toBe(1);
+        (0, vitest_1.expect)(report.byCommand.some((entry) => entry.command === 'doctor')).toBe(true);
+    });
+});
+//# sourceMappingURL=telemetry.test.js.map

package/dist/__tests__/telemetry.test.js.map

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

package/dist/commands/adf-bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adf-bundle.d.ts","sourceRoot":"","sources":["../../src/commands/adf-bundle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CA8HrE"}
+{"version":3,"file":"adf-bundle.d.ts","sourceRoot":"","sources":["../../src/commands/adf-bundle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAyJrE"}