@warnyin/sdlc 0.8.0 → 0.10.0

package/payload/templates/harness.md

@@ -1,34 +1,34 @@
-# Harness — <project>
-<!-- cap:60 · CONFIGURE-phase output; reviewed like code. Registry + tables only — doctrine lives in sdlc/.playbook/. -->
-
-## Tools & MCP (what the agent may call)
-| Tool/MCP | Scope | Notes |
-|---|---|---|
-| <tool> | <what it may touch> | <when to use> |
-
-## Sandbox & execution
-- test command: `<cmd>`
-- sandbox notes: <where code runs, what it cannot reach>
-
-## Guardrails (mirror of installed hooks — deterministic, the agent cannot skip them)
-- `sdlc/specs/**` and archive are write-locked outside ship.
-- Artifact line caps validated on every write.
-- Session token/cost journaled per change.
-
-## Model routing (generic tiers — the harness adapter maps them to real models)
-| Task kind | Tier |
-|---|---|
-| requirements, architecture, deep design | deepest |
-| standard implementation | balanced |
-| test generation, review passes, mechanical/scaffold, eval judging, learning | cheap |
-
-## Tier triage (stakes → tier)
-- vibe: reversible, no behavior-contract change, ≤2 files.
-- deep: security / payments / data-loss / irreversible surface, new capability, or multi-capability delta.
-- otherwise: standard.
-
-## Autonomy policy
-- auto-ship: vibe, standard.
-- escalate to human: hard-floor (security, payments, data-loss, irreversible), verify failed > 3 rounds,
-  token budget exceeded, information the agent cannot obtain or safely assume,
-  installing a skill or agent (suggest only; see `.playbook/lenses.md`).
+# Harness — <project>
+<!-- cap:60 · CONFIGURE-phase output; reviewed like code. Registry + tables only — doctrine lives in sdlc/.playbook/. -->
+
+## Tools & MCP (what the agent may call)
+| Tool/MCP | Scope | Notes |
+|---|---|---|
+| <tool> | <what it may touch> | <when to use> |
+
+## Sandbox & execution
+- test command: `<cmd>`
+- sandbox notes: <where code runs, what it cannot reach>
+
+## Guardrails (mirror of installed hooks — deterministic, the agent cannot skip them)
+- `sdlc/specs/**` and archive are write-locked outside ship.
+- Artifact line caps validated on every write.
+- Session token/cost journaled per change.
+
+## Model routing (generic tiers — the harness adapter maps them to real models)
+| Task kind | Tier |
+|---|---|
+| requirements, architecture, deep design | deepest |
+| standard implementation | balanced |
+| test generation, review passes, mechanical/scaffold, eval judging, learning | cheap |
+
+## Tier triage (stakes → tier)
+- vibe: reversible, no behavior-contract change, ≤2 files.
+- deep: security / payments / data-loss / irreversible surface, new capability, or multi-capability delta.
+- otherwise: standard.
+
+## Autonomy policy
+- auto-ship: vibe, standard.
+- escalate to human: hard-floor (security, payments, data-loss, irreversible), verify failed > 3 rounds,
+  token budget exceeded, information the agent cannot obtain or safely assume,
+  installing a skill or agent (suggest only; see `.playbook/lenses.md`).

package/payload/templates/spec.md

@@ -1,14 +1,14 @@
-# Spec: <capability>
-<!-- cap:150 (soft) · living spec — observable behavior only, no implementation detail. Split the capability beyond the cap. -->
-
-## Purpose
-<!-- one or two lines; commands grep this header first (progressive disclosure) -->
-
-## Requirements
-
-### Requirement: <name>
-The system SHALL <behavior>.
-
-#### Scenario: <name>
-- WHEN <condition>
-- THEN <observable outcome>
+# Spec: <capability>
+<!-- cap:150 (soft) · living spec — observable behavior only, no implementation detail. Split the capability beyond the cap. -->
+
+## Purpose
+<!-- one or two lines; commands grep this header first (progressive disclosure) -->
+
+## Requirements
+
+### Requirement: <name>
+The system SHALL <behavior>.
+
+#### Scenario: <name>
+- WHEN <condition>
+- THEN <observable outcome>

package/payload/templates/steering.md

@@ -1,9 +1,9 @@
----
-name: <topic>
-inclusion: paths            # always | paths | manual | agent
-pathMatch: ["src/<area>/**"]
----
-# Steering: <topic>
-<!-- cap:40 · loaded only when pathMatch hits or explicitly requested. Dense, scoped conventions — no generalities. -->
-
-<conventions, gotchas, and reference patterns for this scope>
+---
+name: <topic>
+inclusion: paths            # always | paths | manual | agent
+pathMatch: ["src/<area>/**"]
+---
+# Steering: <topic>
+<!-- cap:40 · loaded only when pathMatch hits or explicitly requested. Dense, scoped conventions — no generalities. -->
+
+<conventions, gotchas, and reference patterns for this scope>

package/scripts/validate.mjs

@@ -1,47 +1,47 @@
-#!/usr/bin/env node
-// Thin CLI wrapper — validator core lives in lib/validate.mjs so that
-// installed hooks (sdlc/.hooks/lib/) can share the exact same logic.
-// Exit codes: 0 = clean, 1 = errors, 2 = usage/setup error.
-
-import fs from 'node:fs';
-import path from 'node:path';
-import process from 'node:process';
-import { fileURLToPath } from 'node:url';
-import { validateAll, formatIssues } from '../lib/validate.mjs';
-
-export * from '../lib/validate.mjs';
-
-function main() {
-  const args = process.argv.slice(2);
-  const strict = args.includes('--strict');
-  const rootIdx = args.indexOf('--root');
-  const projectRoot = rootIdx !== -1 ? args[rootIdx + 1] : process.cwd();
-  const positional = args.filter((a, i) => !a.startsWith('--') && args[i - 1] !== '--root');
-  const changeId = positional[0] && positional[0] !== '--all' ? positional[0] : null;
-
-  const sdlcRoot = path.join(projectRoot, 'sdlc');
-  if (!fs.existsSync(sdlcRoot)) {
-    console.error(`No sdlc/ directory at ${projectRoot} — run \`npx @warnyin/sdlc init\` first.`);
-    process.exit(2);
-  }
-
-  const issues = validateAll(sdlcRoot, { strict, changeId });
-  if (issues.length) console.log(formatIssues(issues));
-  const errors = issues.filter((i) => i.level === 'error').length;
-  const warns = issues.length - errors;
-  console.log(`validate: ${errors} error(s), ${warns} warning(s)${strict ? ' [strict]' : ''}`);
-  process.exit(errors > 0 ? 1 : 0);
-}
-
-function isEntrypoint() {
-  if (!process.argv[1]) return false;
-  try {
-    return fs.realpathSync.native(path.resolve(process.argv[1])) === fileURLToPath(import.meta.url);
-  } catch {
-    return false;
-  }
-}
-
-if (isEntrypoint()) {
-  main();
-}
+#!/usr/bin/env node
+// Thin CLI wrapper — validator core lives in lib/validate.mjs so that
+// installed hooks (sdlc/.hooks/lib/) can share the exact same logic.
+// Exit codes: 0 = clean, 1 = errors, 2 = usage/setup error.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import { validateAll, formatIssues } from '../lib/validate.mjs';
+
+export * from '../lib/validate.mjs';
+
+function main() {
+  const args = process.argv.slice(2);
+  const strict = args.includes('--strict');
+  const rootIdx = args.indexOf('--root');
+  const projectRoot = rootIdx !== -1 ? args[rootIdx + 1] : process.cwd();
+  const positional = args.filter((a, i) => !a.startsWith('--') && args[i - 1] !== '--root');
+  const changeId = positional[0] && positional[0] !== '--all' ? positional[0] : null;
+
+  const sdlcRoot = path.join(projectRoot, 'sdlc');
+  if (!fs.existsSync(sdlcRoot)) {
+    console.error(`No sdlc/ directory at ${projectRoot} — run \`npx @warnyin/sdlc init\` first.`);
+    process.exit(2);
+  }
+
+  const issues = validateAll(sdlcRoot, { strict, changeId });
+  if (issues.length) console.log(formatIssues(issues));
+  const errors = issues.filter((i) => i.level === 'error').length;
+  const warns = issues.length - errors;
+  console.log(`validate: ${errors} error(s), ${warns} warning(s)${strict ? ' [strict]' : ''}`);
+  process.exit(errors > 0 ? 1 : 0);
+}
+
+function isEntrypoint() {
+  if (!process.argv[1]) return false;
+  try {
+    return fs.realpathSync.native(path.resolve(process.argv[1])) === fileURLToPath(import.meta.url);
+  } catch {
+    return false;
+  }
+}
+
+if (isEntrypoint()) {
+  main();
+}