specweave 1.0.593 → 2.0.0

package/dist/src/cli/helpers/init/index.js

@@ -35,7 +35,7 @@ export { mergeInstructionFile, parseTemplateSections, getPackageVersion, } from
 export { parseRepoInput, validateAndParseRepoInput, formatRepoInputErrors, promptProjectSetup, promptRepoUrls, mapParsedReposToCloneOptions, runForegroundClone, FOREGROUND_CLONE_THRESHOLD, promptRepoUrlsLoop, cloneReposIntoWorkspace, // @deprecated — kept for backward compat
  } from './repo-connect.js';
 // Workspace setup (non-empty folder detection — 0640)
-export { scanWorkspaceContent, promptMigrationChoice, promptStartEmptySubChoice, restructureIntoRepositories, copyLocalPathIntoRepositories, showRestructureWarnings, detectOrgRepo, promptOrgRepo, } from './workspace-setup.js';
+export { scanWorkspaceContent, promptMigrationChoice, promptStartEmptySubChoice, restructureIntoRepositories, copyLocalPathIntoRepositories, showRestructureWarnings, detectOrgRepo, promptOrgRepo, shouldScaffoldWorkspaceDir, } from './workspace-setup.js';
 // Root repo detection (early GitHub connection — 0640)
 export { detectRootRepo, promptRootRepoConnection, } from './root-repo-detection.js';
 // Skill-creator auto-installer (v1.0.548+)

package/dist/src/cli/helpers/init/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sCAAsC;AACtC,OAAO,EACL,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GAEb,MAAM,wBAAwB,CAAC;AAEhC,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,wDAAwD;AACxD,OAAO,EACL,cAAc,GAEf,MAAM,yBAAyB,CAAC;AAEjC,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EACL,iBAAiB,GAGlB,MAAM,uBAAuB,CAAC;AAE/B,iBAAiB;AACjB,OAAO,EACL,uBAAuB,EACvB,YAAY,GACb,MAAM,4BAA4B,CAAC;AAEpC,6CAA6C;AAC7C,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,GAEtB,MAAM,yBAAyB,CAAC;AAEjC,sBAAsB;AACtB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,aAAa;AACb,OAAO,EACL,aAAa,GAEd,MAAM,iBAAiB,CAAC;AAEzB,yBAAyB;AACzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,gDAAgD;AAChD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAIlB,MAAM,8BAA8B,CAAC;AAEtC,6CAA6C;AAC7C,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,EAAE,yCAAyC;EAOnE,MAAM,mBAAmB,CAAC;AAE3B,sDAAsD;AACtD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,aAAa,EACb,aAAa,GAId,MAAM,sBAAsB,CAAC;AAE9B,uDAAuD;AACvD,OAAO,EACL,cAAc,EACd,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAElC,2CAA2C;AAC3C,OAAO,EACL,kBAAkB,GAEnB,MAAM,8BAA8B,CAAC;AAEtC,sEAAsE;AACtE,OAAO,EACL,gBAAgB,GAEjB,MAAM,0BAA0B,CAAC;AAElC,yCAAyC;AACzC,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,GAIf,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sCAAsC;AACtC,OAAO,EACL,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GAEb,MAAM,wBAAwB,CAAC;AAEhC,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,wDAAwD;AACxD,OAAO,EACL,cAAc,GAEf,MAAM,yBAAyB,CAAC;AAEjC,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EACL,iBAAiB,GAGlB,MAAM,uBAAuB,CAAC;AAE/B,iBAAiB;AACjB,OAAO,EACL,uBAAuB,EACvB,YAAY,GACb,MAAM,4BAA4B,CAAC;AAEpC,6CAA6C;AAC7C,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,GAEtB,MAAM,yBAAyB,CAAC;AAEjC,sBAAsB;AACtB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,aAAa;AACb,OAAO,EACL,aAAa,GAEd,MAAM,iBAAiB,CAAC;AAEzB,yBAAyB;AACzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,gDAAgD;AAChD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAIlB,MAAM,8BAA8B,CAAC;AAEtC,6CAA6C;AAC7C,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,EAAE,yCAAyC;EAOnE,MAAM,mBAAmB,CAAC;AAE3B,sDAAsD;AACtD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,0BAA0B,GAI3B,MAAM,sBAAsB,CAAC;AAE9B,uDAAuD;AACvD,OAAO,EACL,cAAc,EACd,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAElC,2CAA2C;AAC3C,OAAO,EACL,kBAAkB,GAEnB,MAAM,8BAA8B,CAAC;AAEtC,sEAAsE;AACtE,OAAO,EACL,gBAAgB,GAEjB,MAAM,0BAA0B,CAAC;AAElC,yCAAyC;AACzC,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,GAIf,MAAM,0BAA0B,CAAC"}

package/dist/src/cli/helpers/init/instruction-file-merger.d.ts

@@ -1,28 +1,107 @@
 /**
- * Instruction File Merger - Smart CLAUDE.md/AGENTS.md merge
- * Updates SW sections, preserves user content
+ * Instruction File Merger (2.0) - CLAUDE.md / AGENTS.md
+ *
+ * parse → classify → render.
+ *
+ * File layout produced:
+ *   [user content that was above the META line]
+ *   <!-- SW:META template=".." version=".." sections=".." -->
+ *   <!-- SW:SECTION:id version=".." --> … <!-- SW:END:id -->   (template order)
+ *   [user-owned tail: ## Commands / ## Project notes]        (added once)
+ *   [all other user content, in original order]
+ *
+ * Guarantees:
+ * - user content (anything outside SW markers) is never dropped
+ * - sections removed from the template are deleted, ids reported
+ * - a section's version attr changes only when its body changed
+ * - idempotent: a second run over the output is byte-identical
+ * - broken markers are repaired (body kept as user content), never abort
+ * - legacy 1.x files (no markers, or "↓ ORIGINAL ↓" stacks) are stripped of
+ *   known 1.x template blocks by heading and de-duplicated
  */
+import type { StackCommands } from './stack-detector.js';
 export type TemplateType = 'claude' | 'agents';
+/** Major version of the managed-block schema. Files below it are migrated. */
+export declare const TEMPLATE_SCHEMA_MAJOR = 2;
 export interface TemplateSection {
     id: string;
     order: number;
     required: boolean;
+    /**
+     * Name of the condition flag (`<!-- SECTION:umbrella when="umbrella" -->`).
+     * The section is rendered only when `MergeOptions.flags[when]` is true, and is
+     * removed from an existing file when the flag turns false.
+     */
+    when?: string;
     content: string;
 }
+export interface ParsedTemplate {
+    sections: TemplateSection[];
+    /** Content after the last `<!-- /SECTION -->`: user-owned, emitted once. */
+    tail: string;
+}
+export interface MergeOptions {
+    /** Template tail (user-owned). Ignored when a ParsedTemplate is passed. */
+    tail?: string;
+    /** Detected project commands for the {{BUILD_CMD}} family of placeholders. */
+    commands?: StackCommands;
+    /** Condition flags for `when="…"` sections (e.g. `{ umbrella: true }`). */
+    flags?: Record<string, boolean>;
+}
+export interface MigrationInfo {
+    fromVersion: string;
+    removed: string[];
+}
 export interface MergeResult {
     content: string;
-    action: 'created' | 'merged' | 'preserved';
+    action: 'created' | 'merged' | 'unchanged';
     updated: string[];
     added: string[];
+    removed: string[];
     preserved: number;
     warnings: string[];
+    migration: MigrationInfo | null;
 }
-export declare function mergeInstructionFile(existing: string | null, secs: TemplateSection[], type: TemplateType, ver: string, name: string): MergeResult;
+export declare function parseTemplate(content: string): ParsedTemplate;
+export declare function parseTemplateSections(content: string): TemplateSection[];
+/** A file split into the region SpecWeave manages and the region the user owns. */
+export interface ManagedRegions {
+    /** False when the file carries no SW:META / SW:SECTION markers at all. */
+    hasMarkers: boolean;
+    /** Concatenated bodies of the SW:SECTION regions SpecWeave generates. */
+    managed: string;
+    /** Everything else — the user's own writing, preserved verbatim by the merger. */
+    user: string;
+}
+/**
+ * Split an instruction file into managed vs user-owned content, using the very
+ * same marker parser the merger uses to preserve user content (`parseFile`), so
+ * there is exactly one implementation of the SW marker grammar.
+ *
+ * A file with no markers (a legacy 1.x file `update` has not touched yet) is
+ * entirely user-owned.
+ */
+export declare function splitManagedRegions(raw: string): ManagedRegions;
 /**
- * Strip all SW-managed sections from an instruction file, returning only user content.
- * Returns null if no user content remains (file was 100% SW-managed or empty).
+ * Fill `{{BUILD_CMD}}` / `{{TEST_CMD}}` / `{{LINT_CMD}}` (and the TODO marker a
+ * previous run may have left) only where they are still present. Guarantees no
+ * `{{…}}` placeholder survives into a written instruction file.
+ */
+export declare function fillCommandPlaceholders(text: string, commands?: StackCommands): string;
+export declare function mergeInstructionFile(existing: string | null, secs: TemplateSection[] | ParsedTemplate, type: TemplateType, ver: string, name: string, opts?: MergeOptions): MergeResult;
+/**
+ * Strip all SW-managed content from an instruction file, returning only user
+ * content (null when nothing is left). Used by `specweave uninstall`.
  */
 export declare function stripSwSections(content: string): string | null;
-export declare function parseTemplateSections(content: string): TemplateSection[];
+/**
+ * Read specweave's own package.json (not the user's project).
+ * Resolves reliably with symlinked installs (nvm, pnpm, npm link); falls back to a directory walk.
+ */
+export declare function readSpecweavePackageJson(): Record<string, any>;
 export declare function getPackageVersion(): string;
+/**
+ * Minimum Node.js version from specweave's package.json `engines.node` (e.g. ">=20.12.0" → "20.12.0").
+ */
+export declare function getMinNodeVersion(): string;
 //# sourceMappingURL=instruction-file-merger.d.ts.map

package/dist/src/cli/helpers/init/instruction-file-merger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instruction-file-merger.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/instruction-file-merger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAkHD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,IAAI,EAAE,eAAe,EAAE,EACvB,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,WAAW,CA2Fb;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe9D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CA+CxE;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAwB1C"}
+{"version":3,"file":"instruction-file-merger.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/instruction-file-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/C,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;CACjC;AA2HD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CA0C7D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAExE;AAkID,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAS/D;AAkMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM,CAatF;AAyBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,IAAI,EAAE,eAAe,EAAE,GAAG,cAAc,EACxC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,YAAiB,GACtB,WAAW,CAoIb;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAwB9D;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C"}