@productbrain/cli 0.1.0-beta.1395 → 0.1.0-beta.13957

package/dist/surfaces/registry.d.ts

@@ -1,76 +0,0 @@
-/**
- * Surface Capability Registry — WP-310 S0 (FEAT-959), extended in WP-421 S2c (DEC-952).
- *
- * Static typed record of per-surface capabilities consumed by E1–E4 and the
- * SurfaceAdapter set introduced in WP-421 S2c. The legacy `SURFACE_REGISTRY`
- * shape is preserved verbatim for callers (handshake hook plumbing,
- * `lib/hook-intents.ts`, existing tests).
- *
- * INS-740: Cursor and Copilot had confirmed double-fire risk with Claude Code hooks.
- * Their hookEvents arrays MUST be empty in v1. Only 'claude' gets hook events by default.
- */
-import type { SurfaceAdapter } from './adapter.js';
-export type SurfaceName = 'claude' | 'cursor' | 'copilot' | 'codex';
-export interface SurfaceCapability {
-    rulesFormat: 'markdown' | 'mdc';
-    skillsFormat: 'markdown' | 'none';
-    /** Hook events to project. Empty array = no default hook writes (INS-740 double-fire risk). */
-    hookEvents: string[];
-    /** Path to the surface's personal config file. */
-    hookFilePath: string;
-    personalConfigMechanism: 'settings_json' | 'none';
-    supportsAgentsMd: boolean;
-}
-export declare const SURFACE_REGISTRY: Record<SurfaceName, SurfaceCapability>;
-/**
- * Per-surface adapter registry. New surface = new adapter file + line here.
- * Adapters expose detect/paths/transform/goldens/canonicalPathFor — one canonical
- * asset, many surface projections.
- */
-export declare const SURFACE_ADAPTERS: Record<SurfaceName, SurfaceAdapter>;
-/** Convenience array view for iteration (e.g. detect-all). */
-export declare const SURFACE_ADAPTER_LIST: SurfaceAdapter[];
-/**
- * Lookup the canonical authoring path for a projection path on any surface.
- * Returns the first non-null mapping; if every adapter returns null, returns null
- * and the caller MUST emit `surface-reverse-map-missing` telemetry via
- * `surfaces/telemetry.ts:reportReverseMapMissing`.
- */
-export declare function canonicalPathForAnySurface(projectionPath: string): {
-    surface: SurfaceName;
-    canonicalPath: string;
-} | null;
-/** Govern mode declared with empty surfaces[]. Hard error (handshake refuses). */
-export declare const SURFACE_GOVERN_NO_SURFACES: "govern-no-surfaces";
-/** Surface name in manifest is not registered. Advisory flag for drift report. */
-export declare const SURFACE_ADAPTER_MISSING: "surface-adapter-missing";
-/**
- * Result of the surfaces validation for a given authority mode.
- *
- * - `error` is set when the configuration is invalid for the requested mode
- *   (today: only Govern + empty surfaces). Caller should refuse to proceed.
- * - `unregisteredSurfaces` enumerates manifest surface names that are not in
- *   SURFACE_ADAPTERS; emit one `SURFACE_ADAPTER_MISSING` flag per entry but
- *   do NOT fail.
- */
-export interface SurfacesValidationResult {
-    error?: typeof SURFACE_GOVERN_NO_SURFACES;
-    unregisteredSurfaces: string[];
-    /** Subset of `manifest.surfaces` that resolve to a known SurfaceName. */
-    registeredSurfaces: SurfaceName[];
-}
-/**
- * Validate `manifest.surfaces[]` against the requested authority mode.
- *
- * Govern + empty surfaces → `{ error: SURFACE_GOVERN_NO_SURFACES }`.
- * Any other mode is permitted with any (possibly empty) surface list.
- *
- * Unregistered surface names are reported via `unregisteredSurfaces` so the
- * caller can flag them in the drift report. Pure: no I/O, no Convex calls.
- *
- * Surface name normalization: this validator strips a leading `.` from each
- * entry (e.g. `.cursor` → `cursor`) so manifests can declare either form.
- * The canonical SurfaceName values in SURFACE_ADAPTERS use the bare name.
- */
-export declare function validateSurfacesForMode(mode: 'off' | 'observe' | 'project' | 'govern', surfacesFromManifest: string[]): SurfacesValidationResult;
-//# sourceMappingURL=registry.d.ts.map

package/dist/surfaces/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/surfaces/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,UAAU,GAAG,KAAK,CAAC;IAChC,YAAY,EAAE,UAAU,GAAG,MAAM,CAAC;IAClC,+FAA+F;IAC/F,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,eAAe,GAAG,MAAM,CAAC;IAClD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAiCnE,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,cAAc,CAKhE,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAAoC,CAAC;AAEtF;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,MAAM,GACrB;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMxD;AAaD,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,EAAG,oBAA6B,CAAC;AAExE,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,EAAG,yBAAkC,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,OAAO,0BAA0B,CAAC;IAC1C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,yEAAyE;IACzE,kBAAkB,EAAE,WAAW,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,EAC9C,oBAAoB,EAAE,MAAM,EAAE,GAC7B,wBAAwB,CAuB1B"}

package/dist/surfaces/registry.js

@@ -1,117 +0,0 @@
-import { claudeAdapter } from './adapters/claude.js';
-import { cursorAdapter } from './adapters/cursor.js';
-import { copilotAdapter } from './adapters/copilot.js';
-import { codexAdapter } from './adapters/codex.js';
-export const SURFACE_REGISTRY = {
-    claude: {
-        rulesFormat: 'markdown',
-        skillsFormat: 'markdown',
-        hookEvents: ['SessionStart', 'Stop', 'PreCompact'],
-        hookFilePath: '.claude/settings.json',
-        personalConfigMechanism: 'settings_json',
-        supportsAgentsMd: false,
-    },
-    cursor: {
-        rulesFormat: 'mdc',
-        skillsFormat: 'markdown',
-        hookEvents: [], // empty per INS-740 — no default Cursor hook writes
-        hookFilePath: '.cursor/settings.json',
-        personalConfigMechanism: 'none',
-        supportsAgentsMd: false,
-    },
-    copilot: {
-        rulesFormat: 'markdown',
-        skillsFormat: 'none',
-        hookEvents: [], // empty per INS-740
-        hookFilePath: '.github/copilot-instructions.md',
-        personalConfigMechanism: 'none',
-        supportsAgentsMd: false,
-    },
-    codex: {
-        rulesFormat: 'markdown',
-        skillsFormat: 'markdown',
-        hookEvents: [],
-        hookFilePath: 'AGENTS.md',
-        personalConfigMechanism: 'none',
-        supportsAgentsMd: true,
-    },
-};
-// ── SurfaceAdapter registry — WP-421 S2c (DEC-952) ──────────────────────────
-/**
- * Per-surface adapter registry. New surface = new adapter file + line here.
- * Adapters expose detect/paths/transform/goldens/canonicalPathFor — one canonical
- * asset, many surface projections.
- */
-export const SURFACE_ADAPTERS = {
-    claude: claudeAdapter,
-    cursor: cursorAdapter,
-    copilot: copilotAdapter,
-    codex: codexAdapter,
-};
-/** Convenience array view for iteration (e.g. detect-all). */
-export const SURFACE_ADAPTER_LIST = Object.values(SURFACE_ADAPTERS);
-/**
- * Lookup the canonical authoring path for a projection path on any surface.
- * Returns the first non-null mapping; if every adapter returns null, returns null
- * and the caller MUST emit `surface-reverse-map-missing` telemetry via
- * `surfaces/telemetry.ts:reportReverseMapMissing`.
- */
-export function canonicalPathForAnySurface(projectionPath) {
-    for (const surface of Object.keys(SURFACE_ADAPTERS)) {
-        const result = SURFACE_ADAPTERS[surface].canonicalPathFor(projectionPath);
-        if (result)
-            return { surface, canonicalPath: result };
-    }
-    return null;
-}
-// ── WP-421 S7: mode × surfaces matrix (doneWhen #19) ─────────────────────────
-//
-// Two stable error/flag codes (consumer-stable contract):
-//   - SURFACE_GOVERN_NO_SURFACES — Govern mode requires a non-empty surfaces[].
-//     Emitted by `validateSurfacesForMode` when `materialize: govern` and no
-//     surfaces declared. CLI surfaces this as a hard error.
-//   - SURFACE_ADAPTER_MISSING — A surface name in `manifest.surfaces[]` is not
-//     registered in SURFACE_ADAPTERS. Emitted by `flagUnregisteredSurfaces` for
-//     the drift report. The handshake MUST NOT crash on this — the flag is
-//     advisory and the handshake skips the unknown surface.
-/** Govern mode declared with empty surfaces[]. Hard error (handshake refuses). */
-export const SURFACE_GOVERN_NO_SURFACES = 'govern-no-surfaces';
-/** Surface name in manifest is not registered. Advisory flag for drift report. */
-export const SURFACE_ADAPTER_MISSING = 'surface-adapter-missing';
-/**
- * Validate `manifest.surfaces[]` against the requested authority mode.
- *
- * Govern + empty surfaces → `{ error: SURFACE_GOVERN_NO_SURFACES }`.
- * Any other mode is permitted with any (possibly empty) surface list.
- *
- * Unregistered surface names are reported via `unregisteredSurfaces` so the
- * caller can flag them in the drift report. Pure: no I/O, no Convex calls.
- *
- * Surface name normalization: this validator strips a leading `.` from each
- * entry (e.g. `.cursor` → `cursor`) so manifests can declare either form.
- * The canonical SurfaceName values in SURFACE_ADAPTERS use the bare name.
- */
-export function validateSurfacesForMode(mode, surfacesFromManifest) {
-    const knownNames = new Set(Object.keys(SURFACE_ADAPTERS));
-    const registeredSurfaces = [];
-    const unregisteredSurfaces = [];
-    for (const raw of surfacesFromManifest) {
-        if (typeof raw !== 'string' || raw.length === 0)
-            continue;
-        const stripped = raw.startsWith('.') ? raw.slice(1) : raw;
-        const normalized = stripped === 'github' ? 'copilot' : stripped;
-        if (knownNames.has(normalized)) {
-            registeredSurfaces.push(normalized);
-        }
-        else {
-            unregisteredSurfaces.push(raw);
-        }
-    }
-    // Govern requires at least one registered surface. Unregistered surface names
-    // do NOT count toward this minimum (they're advisory).
-    if (mode === 'govern' && registeredSurfaces.length === 0) {
-        return { error: SURFACE_GOVERN_NO_SURFACES, unregisteredSurfaces, registeredSurfaces };
-    }
-    return { unregisteredSurfaces, registeredSurfaces };
-}
-//# sourceMappingURL=registry.js.map

package/dist/surfaces/registry.js.map

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

package/dist/surfaces/telemetry.d.ts

@@ -1,17 +0,0 @@
-export interface ReverseMapMissingEvent {
-    surface: string;
-    projectionPath: string;
-}
-/**
- * Stable, copy-paste-able fallback message used by tampered-bucket prompts when
- * an adapter cannot reverse-map a projection path. Centralized so every consumer
- * surfaces the exact same instruction string.
- */
-export declare function getReverseMapFallbackMessage(): string;
-/**
- * Report that an adapter returned null for canonicalPathFor.
- * Always emits a telemetry event; also writes a tagged warning to stderr so
- * developers see it during local handshake runs.
- */
-export declare function reportReverseMapMissing(evt: ReverseMapMissingEvent, warn?: (msg: string) => void): void;
-//# sourceMappingURL=telemetry.d.ts.map

package/dist/surfaces/telemetry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/surfaces/telemetry.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAKD;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAgD,GACtE,IAAI,CAQN"}

package/dist/surfaces/telemetry.js

@@ -1,31 +0,0 @@
-/**
- * Surface telemetry — WP-421 S2c.
- *
- * Tagged log + PostHog event for unmapped projection paths. When a SurfaceAdapter's
- * canonicalPathFor returns null, the consumer falls back to a generic
- * "edit upstream in .productbrain/{skills,rules,hooks}/" message and emits
- * `surface-reverse-map-missing` for observability.
- */
-import { trackEvent } from '../lib/telemetry.js';
-const FALLBACK_MESSAGE = 'edit upstream in .productbrain/skills|rules|hooks/';
-/**
- * Stable, copy-paste-able fallback message used by tampered-bucket prompts when
- * an adapter cannot reverse-map a projection path. Centralized so every consumer
- * surfaces the exact same instruction string.
- */
-export function getReverseMapFallbackMessage() {
-    return FALLBACK_MESSAGE;
-}
-/**
- * Report that an adapter returned null for canonicalPathFor.
- * Always emits a telemetry event; also writes a tagged warning to stderr so
- * developers see it during local handshake runs.
- */
-export function reportReverseMapMissing(evt, warn = (msg) => process.stderr.write(msg + '\n')) {
-    trackEvent('surface-reverse-map-missing', {
-        surface: evt.surface,
-        projectionPath: evt.projectionPath,
-    });
-    warn(`[surface-reverse-map-missing] ${evt.surface} cannot reverse-map ${evt.projectionPath} — ${FALLBACK_MESSAGE}`);
-}
-//# sourceMappingURL=telemetry.js.map

package/dist/surfaces/telemetry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/surfaces/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOjD,MAAM,gBAAgB,GACpB,oDAAoD,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAA2B,EAC3B,OAA8B,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC;IAEvE,UAAU,CAAC,6BAA6B,EAAE;QACxC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,cAAc,EAAE,GAAG,CAAC,cAAc;KACnC,CAAC,CAAC;IACH,IAAI,CACF,iCAAiC,GAAG,CAAC,OAAO,uBAAuB,GAAG,CAAC,cAAc,MAAM,gBAAgB,EAAE,CAC9G,CAAC;AACJ,CAAC"}

package/templates/archetypes/boundary.md

@@ -1,23 +0,0 @@
----
-name: chain-boundaries
-description: "{{entry_count}} system boundaries derived from Chain architecture entries"
-autoApply: true
-level: core
----
-
-# Chain-Derived System Boundaries
-
-These {{entry_count}} architecture and decision entries define system boundaries for this workspace. Do not cross a boundary without understanding the contract it defines.
-
-**Boundary entries:** {{entry_ids}}
-
-{{boundary_summary}}
-
-## What this means
-
-- Boundaries define what a domain owns and what it does not own.
-- Cross-domain changes require explicit negotiation — check the Team APIs in `docs/system/domains/`.
-- Run `pb get <ID>` to read the full boundary entry before touching cross-domain seams.
-- If your change crosses a domain boundary, identify the owning domain first (domain-boundaries rule).
-
-**Source entries (names):** {{entry_names}}

package/templates/archetypes/constraint.md

@@ -1,23 +0,0 @@
----
-name: chain-constraints
-description: "{{entry_count}} implementation constraints derived from Chain governance entries"
-autoApply: true
-level: core
----
-
-# Chain-Derived Constraints
-
-These {{entry_count}} governance entries constrain implementation in this workspace. Before writing code that touches any affected domain, check these entries on the Chain.
-
-**Constraint entries:** {{entry_ids}}
-
-{{constraint_summary}}
-
-## What this means
-
-- These standards and rules are non-negotiable. They constrain behavior across all slices.
-- Run `pb get <ID>` to read the full entry before implementing anything in its domain.
-- If your change conflicts with a constraint, capture a tension before proceeding.
-- "I didn't know" is not a valid defense when the constraint is on the Chain.
-
-**Source entries (names):** {{entry_names}}

package/templates/archetypes/convention.md

@@ -1,23 +0,0 @@
----
-name: chain-conventions
-description: "{{entry_count}} conventions derived from Chain decision and pattern entries"
-autoApply: true
-level: core
----
-
-# Chain-Derived Conventions
-
-These {{entry_count}} decision and pattern entries establish conventions for this workspace. Follow them unless you have a decision on the Chain that says otherwise.
-
-**Convention entries:** {{entry_ids}}
-
-{{convention_summary}}
-
-## What this means
-
-- Conventions are established patterns, not suggestions. They reduce decision fatigue.
-- Before inventing a new pattern, search the Chain — it may already be a convention.
-- Run `pb get <ID>` to understand the rationale behind a convention before deviating.
-- If you must deviate, capture a DEC on the Chain explaining the new direction.
-
-**Source entries (names):** {{entry_names}}

package/templates/archetypes/policy.md

@@ -1,23 +0,0 @@
----
-name: chain-policies
-description: "{{entry_count}} operational policies derived from Chain policy and business-rule entries"
-autoApply: true
-level: core
----
-
-# Chain-Derived Policies
-
-These {{entry_count}} policy and business-rule entries govern workflows and access in this workspace. Policies apply even when they are inconvenient.
-
-**Policy entries:** {{entry_ids}}
-
-{{policy_summary}}
-
-## What this means
-
-- Policies govern who can do what and under what conditions.
-- Security, auth, and access control policies are never optional.
-- Run `pb get <ID>` to read the full policy before implementing anything in its domain.
-- If a policy conflicts with a feature requirement, capture a TEN and escalate — do not quietly violate.
-
-**Source entries (names):** {{entry_names}}

package/templates/archetypes/quality-gate.md

@@ -1,23 +0,0 @@
----
-name: chain-quality-gates
-description: "{{entry_count}} quality gates derived from Chain standard and business-rule entries"
-autoApply: true
-level: core
----
-
-# Chain-Derived Quality Gates
-
-These {{entry_count}} standard and business-rule entries define quality gates that must pass before shipping. No exceptions without a documented reason on the Chain.
-
-**Quality gate entries:** {{entry_ids}}
-
-{{quality_summary}}
-
-## What this means
-
-- Quality gates are pass/fail. They are not approximate.
-- Run `npm run build` and `npm run test` before every push — always.
-- Run `pb get <ID>` to read the specific acceptance criteria for a quality gate.
-- If a gate cannot pass due to a legitimate constraint, capture a TEN before shipping.
-
-**Source entries (names):** {{entry_names}}

package/templates/archetypes/workflow.md

@@ -1,23 +0,0 @@
----
-name: chain-workflows
-description: "{{entry_count}} required process flows derived from Chain flow entries"
-autoApply: true
-level: core
----
-
-# Chain-Derived Workflows
-
-These {{entry_count}} flow entries define required processes for this workspace. If a workflow entry exists for a process you are about to execute, follow it.
-
-**Workflow entries:** {{entry_ids}}
-
-{{workflow_summary}}
-
-## What this means
-
-- Workflows define the correct sequence of steps for key processes.
-- Skipping a step is not the same as completing the workflow.
-- Run `pb get <ID>` to read the full workflow before executing the process it defines.
-- If the workflow is incomplete or outdated, capture a TEN — do not silently deviate.
-
-**Source entries (names):** {{entry_names}}

package/templates/general/code-integrity.md

@@ -1,11 +0,0 @@
----
-name: code-integrity
-description: General code quality patterns
-level: core
----
-
-# Code Integrity
-
-- Derive from the source of truth, don't duplicate
-- Handle errors at boundaries, not everywhere
-- Names should describe what, not how

package/templates/general/getting-started.md

@@ -1,12 +0,0 @@
----
-name: getting-started
-description: Product Brain onboarding for new workspaces
-level: core
----
-
-# Getting Started with Product Brain
-
-- Run `pb orient -b` to see your workspace state
-- Run `pb handshake` after changing rules or skills in `.productbrain/`
-- Rules go in `.productbrain/rules/`, skills go in `.productbrain/skills/`
-- The Chain is the single source of truth — use `pb get <ID>` to load any entry

package/templates/method-registry.json

@@ -1,16 +0,0 @@
-{
-  "version": "1.0",
-  "generatedAt": "2026-04-18T00:00:00.000Z",
-  "methods": [
-    { "name": "session start", "usage": "pb session start", "description": "Open a tracked write session before making changes to the Chain." },
-    { "name": "session close", "usage": "pb session close", "description": "Close the current session and prompt for captures." },
-    { "name": "capture", "usage": "pb capture \"TYPE: text\"", "description": "Capture a decision (DEC), tension (TEN), insight (INS), or experiment (EXP) as a draft entry." },
-    { "name": "orient", "usage": "pb orient --task \"<task>\"", "description": "Get task-relevant governance and context before implementation." },
-    { "name": "get", "usage": "pb get <ID>", "description": "Get a full Chain entry by ID (BET, DEC, STD, BR, TEN, etc.)." },
-    { "name": "search", "usage": "pb search <query>", "description": "Search entries across the Chain." },
-    { "name": "handshake", "usage": "pb handshake", "description": "Refresh generated context files from Chain governance." },
-    { "name": "handshake --init", "usage": "pb handshake --init", "description": "Set up Claude Code integration (hooks, permissions, trust level)." },
-    { "name": "update", "usage": "pb update <ID> -f \"field=value\"", "description": "Update a Chain entry field." },
-    { "name": "context", "usage": "pb context <ID>", "description": "Get constellation context for a Chain entry." }
-  ]
-}

package/templates/node-ts/code-integrity.md

@@ -1,13 +0,0 @@
----
-name: code-integrity
-description: TypeScript code quality patterns
-level: core
-when_stack: typescript
----
-
-# Code Integrity
-
-- Use strict TypeScript (`strict: true` in tsconfig)
-- Prefer `const` over `let`
-- Use explicit return types on exported functions
-- Handle errors at boundaries, not everywhere

package/templates/node-ts/testing.md

@@ -1,12 +0,0 @@
----
-name: testing
-description: Testing standards for Node/TypeScript projects
-level: intermediate
-when_stack: typescript
----
-
-# Testing Standards
-
-- Test behavior, not implementation
-- One assertion per test when possible
-- Use descriptive test names that read as specifications

package/templates/python/code-integrity.md

@@ -1,13 +0,0 @@
----
-name: code-integrity
-description: Python code quality patterns
-level: core
-when_stack: python
----
-
-# Code Integrity
-
-- Use type hints on function signatures
-- Prefer f-strings over .format()
-- Handle errors at boundaries, not everywhere
-- Use pathlib over os.path

package/templates/python/testing.md

@@ -1,12 +0,0 @@
----
-name: testing
-description: Testing standards for Python projects
-level: intermediate
-when_stack: python
----
-
-# Testing Standards
-
-- Test behavior, not implementation
-- Use pytest fixtures for shared setup
-- Use descriptive test names that read as specifications