@sdd-method/cli-core 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -27,13 +27,17 @@ Eight sub-module export groups, per ADR 0152 §4.3:
27
27
 
28
28
  | Sub-module export | Purpose | Anchored in |
29
29
  |---|---|---|
30
- | **root** (`@sdd-method/cli-core`) | Workspace + repo-kind discovery — `findSddRoot`, `discoverSddRepos`, `readRepoKind`, `profileFromRepoKind`, `isRepoKind`, `REPO_KIND_FILE`, types `Profile`, `RepoKind`, `DiscoveredRepo` | ADR 0045 sibling-SDD layout, ADR 0118 profile framework |
30
+ | **root** (`@sdd-method/cli-core`) | Workspace + repo-kind discovery — `findSddRoot`, `discoverSddRepos`, `readRepoKind`, `profileFromRepoKind`, `isRepoKind`, `REPO_KIND_FILE`, `LEGACY_REPO_KIND_FILE` (added v0.1.1), types `Profile`, `RepoKind`, `DiscoveredRepo` | ADR 0045 sibling-SDD layout, ADR 0118 profile framework |
31
31
  | `./archetypes` | Archetype registry + render primitives + repo-config writer — `loadRegistry`, `filterByProfile`, `findArchetype`, `renderArchetype`, `writeRepoConfigEntry`, types `ArchetypeRegistry`, `ArchetypeDeclaration`, `RenderOptions`, `RenderOutcome`, `RenderVars`, `WriteRepoConfigInputs`, `WriteRepoConfigResult` | ADR 0118 §6 archetype-output compliance |
32
32
  | `./stability` | Stability-class surfacing shape — `checkStabilityClass`, types `StabilityContext`, `StabilityCheckResult` | ADR 0118 §4.5, ADR 0127 verb stability semantics |
33
33
  | `./pins` (and split sub-paths) | Pin-verb delegation shims — `runContractsVerb`, `runArtifactsVerb`, types `ContractsVerbOptions`, `ContractsVerbResult`, `ArtifactsVerbOptions`, `ArtifactsVerbResult` | ADR 0110 cross-SDD contract pins, ADR 0113 runtime artefact pins |
34
34
  | `./mcp` | MCP envelope + lifecycle + sdd-mcp composition client — `jsonContent`, `errorContent`, `dedupeSources`, `getSddClient`, `shutdownSddClient`, `parseSddToolResult`, `runMcpServer`, `McpEnvelopeError`, types `McpErrorEnvelope`, `CompositionResult`, `SddClientOptions`, `ParsedSddToolResult`, `RunMcpServerOptions` | ADR 0130 Adopter MCP Composition Pattern |
35
35
  | `./validate` | Manifest + archetype-metadata validators — `checkManifest`, `checkArchetypeMetadata`, types `ManifestCheckIssue`, `ManifestCheckResult`, `ManifestVocabulary`, `ArchetypeMetadataCheckIssue`, `ArchetypeMetadataCheckResult`, `ArchetypeMetadataCheckOptions` | ADR 0143 – ADR 0147 canonical manifest schemas |
36
36
 
37
+ ### v0.1.1 — additive
38
+
39
+ - **root:** export `LEGACY_REPO_KIND_FILE` (`.iteraitive-repo-kind`), the pre-rebrand marker filename, for adopters that detect or migrate legacy repos. Additive (new symbol on the existing root sub-module; no behavioural change — `readRepoKind` still reads only the canonical `REPO_KIND_FILE`). Settles the migration-map gap for the first-adopter (`contextua-clis`) `platform-cli` swap.
40
+
37
41
  ## Out of scope for v0.1.0
38
42
 
39
43
  Six surfaces present in adopter reference implementations but explicitly NOT upstream (per ADR 0152 §4.3):
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { REPO_KIND_FILE, isRepoKind, profileFromRepoKind, readRepoKind, } from "./repo-kind.js";
1
+ export { REPO_KIND_FILE, LEGACY_REPO_KIND_FILE, isRepoKind, profileFromRepoKind, readRepoKind, } from "./repo-kind.js";
2
2
  export type { Profile, RepoKind } from "./repo-kind.js";
3
3
  export { findSddRoot } from "./workspace.js";
4
4
  export { discoverSddRepos } from "./list.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- export { REPO_KIND_FILE, isRepoKind, profileFromRepoKind, readRepoKind, } from "./repo-kind.js";
1
+ export { REPO_KIND_FILE, LEGACY_REPO_KIND_FILE, isRepoKind, profileFromRepoKind, readRepoKind, } from "./repo-kind.js";
2
2
  export { findSddRoot } from "./workspace.js";
3
3
  export { discoverSddRepos } from "./list.js";
4
4
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}
@@ -7,6 +7,15 @@
7
7
  export type Profile = "platform" | "application" | "integration";
8
8
  export type RepoKind = "platform-product" | "application-product" | "integration-product";
9
9
  export declare const REPO_KIND_FILE = ".sdd-repo-kind";
10
+ /**
11
+ * Legacy pre-rebrand marker filename (the `iteraitive` → `sdd` rebrand).
12
+ * Exported for adopters that detect or migrate legacy repos that still carry
13
+ * the old marker. Note: {@link readRepoKind} below reads only the canonical
14
+ * {@link REPO_KIND_FILE}; honouring the legacy marker as a read fallback is a
15
+ * separate, deliberate behavioural choice left to the consumer (or a future
16
+ * library enhancement), not implied by this constant's presence.
17
+ */
18
+ export declare const LEGACY_REPO_KIND_FILE = ".iteraitive-repo-kind";
10
19
  export declare function profileFromRepoKind(kind: RepoKind): Profile;
11
20
  export declare function isRepoKind(value: string): value is RepoKind;
12
21
  export declare function readRepoKind(repoRoot: string): Promise<RepoKind | null>;
@@ -1 +1 @@
1
- {"version":3,"file":"repo-kind.d.ts","sourceRoot":"","sources":["../src/repo-kind.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAQ/C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE3D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAW7E"}
1
+ {"version":3,"file":"repo-kind.d.ts","sourceRoot":"","sources":["../src/repo-kind.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAQ7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE3D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAW7E"}
package/dist/repo-kind.js CHANGED
@@ -7,6 +7,15 @@
7
7
  import { readFile } from "node:fs/promises";
8
8
  import { join } from "node:path";
9
9
  export const REPO_KIND_FILE = ".sdd-repo-kind";
10
+ /**
11
+ * Legacy pre-rebrand marker filename (the `iteraitive` → `sdd` rebrand).
12
+ * Exported for adopters that detect or migrate legacy repos that still carry
13
+ * the old marker. Note: {@link readRepoKind} below reads only the canonical
14
+ * {@link REPO_KIND_FILE}; honouring the legacy marker as a read fallback is a
15
+ * separate, deliberate behavioural choice left to the consumer (or a future
16
+ * library enhancement), not implied by this constant's presence.
17
+ */
18
+ export const LEGACY_REPO_KIND_FILE = ".iteraitive-repo-kind";
10
19
  const PROFILE_BY_REPO_KIND = {
11
20
  "platform-product": "platform",
12
21
  "application-product": "application",
@@ -1 +1 @@
1
- {"version":3,"file":"repo-kind.js","sourceRoot":"","sources":["../src/repo-kind.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE/C,MAAM,oBAAoB,GAAwC;IAChE,kBAAkB,EAAE,UAAU;IAC9B,qBAAqB,EAAE,aAAa;IACpC,qBAAqB,EAAE,aAAa;CACrC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,IAAI,oBAAoB,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"repo-kind.js","sourceRoot":"","sources":["../src/repo-kind.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D,MAAM,oBAAoB,GAAwC;IAChE,kBAAkB,EAAE,UAAU;IAC9B,qBAAqB,EAAE,aAAa;IACpC,qBAAqB,EAAE,aAAa;CACrC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,IAAI,oBAAoB,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sdd-method/cli-core",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Upstream shared TypeScript/Node core for SDD adopter partner-cli and platform-cli binaries. Implements the method-defined surfaces (archetypes, stability, pins, MCP envelope/lifecycle/sdd-client, workspace/repo-kind discovery, manifest + archetype-metadata validation) that recur across every SDD adopter's code-CLI pair per ADR 0118 + ADR 0120 + ADR 0127. Scope locked in ADR 0152.",
5
5
  "keywords": [
6
6
  "sdd-method",