@kaddo/cli 3.121.0 → 3.121.2

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.
Files changed (35) hide show
  1. package/dist/admin-dist/assets/{architectureDiagram-3BPJPVTR-DIMrrmB9.js → architectureDiagram-3BPJPVTR-Dbr18Web.js} +1 -1
  2. package/dist/admin-dist/assets/{chunk-727SXJPM-Dqr01pM2.js → chunk-727SXJPM-BWbB1dny.js} +1 -1
  3. package/dist/admin-dist/assets/{chunk-AQP2D5EJ-Cq-Ux2er.js → chunk-AQP2D5EJ-CkKNMCVl.js} +1 -1
  4. package/dist/admin-dist/assets/{classDiagram-v2-Q7XG4LA2-ggXfKatP.js → classDiagram-4FO5ZUOK-9HavAioX.js} +1 -1
  5. package/dist/admin-dist/assets/{classDiagram-4FO5ZUOK-ggXfKatP.js → classDiagram-v2-Q7XG4LA2-9HavAioX.js} +1 -1
  6. package/dist/admin-dist/assets/{dagre-BM42HDAG-C6oD5ML4.js → dagre-BM42HDAG-CSnvJYn0.js} +1 -1
  7. package/dist/admin-dist/assets/{diagram-2AECGRRQ-hUz_WSJC.js → diagram-2AECGRRQ-D5mzkmrf.js} +1 -1
  8. package/dist/admin-dist/assets/{diagram-5GNKFQAL-ChltTKxS.js → diagram-5GNKFQAL-EOymLNQi.js} +1 -1
  9. package/dist/admin-dist/assets/{diagram-LMA3HP47-DD3kd-Zq.js → diagram-LMA3HP47-CFppr3p_.js} +1 -1
  10. package/dist/admin-dist/assets/{diagram-OG6HWLK6-BKHyHHw0.js → diagram-OG6HWLK6-IpTbPSwx.js} +1 -1
  11. package/dist/admin-dist/assets/{erDiagram-TEJ5UH35-BE5PDGjy.js → erDiagram-TEJ5UH35-Dsw1KXtJ.js} +1 -1
  12. package/dist/admin-dist/assets/{flowDiagram-I6XJVG4X-lxFDGYVc.js → flowDiagram-I6XJVG4X-CqPlWF-A.js} +1 -1
  13. package/dist/admin-dist/assets/{ganttDiagram-6RSMTGT7-BPeceg0v.js → ganttDiagram-6RSMTGT7-jQtBO2ri.js} +1 -1
  14. package/dist/admin-dist/assets/index-Mg4i_77z.js +92 -0
  15. package/dist/admin-dist/assets/{infoDiagram-5YYISTIA-Boe5ho81.js → infoDiagram-5YYISTIA-D5pnfo1x.js} +1 -1
  16. package/dist/admin-dist/assets/{ishikawaDiagram-YF4QCWOH-3T8K6hMf.js → ishikawaDiagram-YF4QCWOH-WxGtRgZ5.js} +1 -1
  17. package/dist/admin-dist/assets/{kanban-definition-UN3LZRKU-BW97uUmp.js → kanban-definition-UN3LZRKU-Buxhd6Vb.js} +1 -1
  18. package/dist/admin-dist/assets/{linear-BGHTsNfG.js → linear-CB4OadYd.js} +1 -1
  19. package/dist/admin-dist/assets/{mindmap-definition-RKZ34NQL-B-LmLGip.js → mindmap-definition-RKZ34NQL-EjTeYtkU.js} +1 -1
  20. package/dist/admin-dist/assets/{pieDiagram-4H26LBE5-BS0ysj7T.js → pieDiagram-4H26LBE5-DNg0vyEp.js} +1 -1
  21. package/dist/admin-dist/assets/{quadrantDiagram-W4KKPZXB-CJbpr-VT.js → quadrantDiagram-W4KKPZXB-Cw1i1NWC.js} +1 -1
  22. package/dist/admin-dist/assets/{requirementDiagram-4Y6WPE33-CTEMRVel.js → requirementDiagram-4Y6WPE33-B08Cqp6h.js} +1 -1
  23. package/dist/admin-dist/assets/{sequenceDiagram-3UESZ5HK-ff_IANYV.js → sequenceDiagram-3UESZ5HK-D5mOyhQb.js} +1 -1
  24. package/dist/admin-dist/assets/{stateDiagram-AJRCARHV-DCJ7-my6.js → stateDiagram-AJRCARHV-DKkcxwEg.js} +1 -1
  25. package/dist/admin-dist/assets/{stateDiagram-v2-BHNVJYJU-tCHje_1l.js → stateDiagram-v2-BHNVJYJU-BM6DzHMK.js} +1 -1
  26. package/dist/admin-dist/assets/{timeline-definition-PNZ67QCA-DMT8_Cuq.js → timeline-definition-PNZ67QCA-BKThSvYE.js} +1 -1
  27. package/dist/admin-dist/assets/{vennDiagram-CIIHVFJN-DRtPPFKO.js → vennDiagram-CIIHVFJN-C0IC5TPV.js} +1 -1
  28. package/dist/admin-dist/assets/{wardleyDiagram-YWT4CUSO-CDN0fFvU.js → wardleyDiagram-YWT4CUSO-dxdvDU4B.js} +1 -1
  29. package/dist/admin-dist/assets/{xychartDiagram-2RQKCTM6-e4oyuMDO.js → xychartDiagram-2RQKCTM6-_OD2E5cs.js} +1 -1
  30. package/dist/admin-dist/index.html +1 -1
  31. package/dist/admin-server/index.js +118 -0
  32. package/dist/core.js +1149 -78
  33. package/dist/index.js +1382 -137
  34. package/package.json +1 -1
  35. package/dist/admin-dist/assets/index-B7GhDkjv.js +0 -92
package/dist/core.js CHANGED
@@ -141,8 +141,8 @@ function loadConfig(dir) {
141
141
  const parsed = configSchema.safeParse(raw ?? {});
142
142
  if (!parsed.success) {
143
143
  const issues = parsed.error.issues.map((i) => {
144
- const path5 = i.path.join(".");
145
- return path5 ? ` - ${path5}: ${i.message}` : ` - ${i.message}`;
144
+ const path6 = i.path.join(".");
145
+ return path6 ? ` - ${path6}: ${i.message}` : ` - ${i.message}`;
146
146
  }).join("\n");
147
147
  throw new ConfigError(`Invalid .kaddo/config.yml:
148
148
  ${issues}`);
@@ -394,11 +394,11 @@ function moduleArtifactCoverage(dir, id) {
394
394
  };
395
395
  }
396
396
  function loadMappedModules(dir) {
397
- const path5 = join(dir, DESCRIPTOR_PATH);
398
- if (!exists(path5)) return [];
397
+ const path6 = join(dir, DESCRIPTOR_PATH);
398
+ if (!exists(path6)) return [];
399
399
  let parsed;
400
400
  try {
401
- parsed = parseYaml3(readFile(path5));
401
+ parsed = parseYaml3(readFile(path6));
402
402
  } catch {
403
403
  return [];
404
404
  }
@@ -1629,7 +1629,7 @@ function sectionParagraph(md, title) {
1629
1629
  }
1630
1630
  return "";
1631
1631
  }
1632
- function parseCapsule(id, path5, md) {
1632
+ function parseCapsule(id, path6, md) {
1633
1633
  const { data } = matter2(md);
1634
1634
  const updatedAt = data.updated_at ? String(data.updated_at) : void 0;
1635
1635
  let ageDays = null;
@@ -1639,7 +1639,7 @@ function parseCapsule(id, path5, md) {
1639
1639
  }
1640
1640
  return {
1641
1641
  id,
1642
- path: path5,
1642
+ path: path6,
1643
1643
  system: data.system ? String(data.system) : id,
1644
1644
  owner: data.owner ? String(data.owner) : void 0,
1645
1645
  updatedAt,
@@ -2004,6 +2004,302 @@ function parseWorkItemResources(fm) {
2004
2004
  return out;
2005
2005
  }
2006
2006
 
2007
+ // src/core/deprecation.ts
2008
+ import matter5 from "gray-matter";
2009
+ var DEPRECATION_ARTIFACT_TYPE = "deprecation-plan";
2010
+ var DEPRECATION_PLANS_DIR = "knowledge/legacy/deprecations";
2011
+ var TARGET_TYPES = [
2012
+ "module",
2013
+ "route",
2014
+ "function",
2015
+ "ui",
2016
+ "job",
2017
+ "database-object",
2018
+ "integration",
2019
+ "config",
2020
+ "other"
2021
+ ];
2022
+ var LIFECYCLE_STATES2 = [
2023
+ "candidate",
2024
+ "usage-validated",
2025
+ "soft-deprecated",
2026
+ "disabled",
2027
+ "removed-devtest",
2028
+ "production-ready",
2029
+ "production-changed",
2030
+ "observing",
2031
+ "completed",
2032
+ "deprecated-retained"
2033
+ ];
2034
+ var LIFECYCLE_TRANSITIONS = {
2035
+ candidate: ["usage-validated", "deprecated-retained"],
2036
+ "usage-validated": ["soft-deprecated", "deprecated-retained"],
2037
+ "soft-deprecated": ["disabled", "deprecated-retained"],
2038
+ disabled: ["removed-devtest", "deprecated-retained"],
2039
+ "removed-devtest": ["production-ready", "deprecated-retained"],
2040
+ "production-ready": ["production-changed"],
2041
+ "production-changed": ["observing"],
2042
+ observing: ["completed", "deprecated-retained"],
2043
+ completed: [],
2044
+ "deprecated-retained": []
2045
+ };
2046
+ var ENVIRONMENTS = ["development", "test", "production"];
2047
+ var ENVIRONMENT_STATES = ["active", "soft-deprecated", "disabled", "removed"];
2048
+ var EVIDENCE_SIGNALS = [
2049
+ "static",
2050
+ "runtime",
2051
+ "database",
2052
+ "external_consumers",
2053
+ "human_review"
2054
+ ];
2055
+ var USAGE_STATUSES = ["no-usage", "usage-found", "unknown", "not-evaluated"];
2056
+ var EVIDENCE_QUALITIES = ["observed-fact", "human-confirmed", "inferred", "unknown"];
2057
+ var SOFT_DEPRECATION_STRATEGIES = [
2058
+ "feature-flag",
2059
+ "hide-ui",
2060
+ "disable-route",
2061
+ "deprecation-warning",
2062
+ "stop-scheduler",
2063
+ "remove-caller",
2064
+ "stop-writes",
2065
+ "read-only",
2066
+ "telemetry",
2067
+ "manual"
2068
+ ];
2069
+ function str2(v) {
2070
+ return typeof v === "string" && v.trim() ? v.trim() : null;
2071
+ }
2072
+ function parseWorkItemDeprecationTargets(fm) {
2073
+ const v = fm.deprecation_targets;
2074
+ if (!Array.isArray(v)) return [];
2075
+ const out = [];
2076
+ for (const raw of v) {
2077
+ if (typeof raw === "string") {
2078
+ const s = raw.trim();
2079
+ if (!s) continue;
2080
+ const slash = s.indexOf("/");
2081
+ if (slash > 0) out.push({ plan: s.slice(0, slash).trim(), target: s.slice(slash + 1).trim() });
2082
+ else out.push({ plan: null, target: s });
2083
+ continue;
2084
+ }
2085
+ if (raw && typeof raw === "object" && !Array.isArray(raw)) {
2086
+ const o = raw;
2087
+ const target = str2(o.target) ?? str2(o.id);
2088
+ if (!target) continue;
2089
+ out.push({ plan: str2(o.plan), target });
2090
+ }
2091
+ }
2092
+ return out;
2093
+ }
2094
+ function strArray2(v) {
2095
+ if (Array.isArray(v)) return v.map((x) => String(x).trim()).filter(Boolean);
2096
+ if (typeof v === "string" && v.trim()) return [v.trim()];
2097
+ return [];
2098
+ }
2099
+ function isValidTargetType(t) {
2100
+ return TARGET_TYPES.includes(t);
2101
+ }
2102
+ function isValidLifecycleState(s) {
2103
+ return LIFECYCLE_STATES2.includes(s);
2104
+ }
2105
+ function isValidEnvironmentState(s) {
2106
+ return ENVIRONMENT_STATES.includes(s);
2107
+ }
2108
+ function isValidLifecycleTransition(from, to) {
2109
+ if (!isValidLifecycleState(from) || !isValidLifecycleState(to)) return false;
2110
+ return LIFECYCLE_TRANSITIONS[from].includes(to);
2111
+ }
2112
+ function parseAssessment(v) {
2113
+ if (!v || typeof v !== "object" || Array.isArray(v)) {
2114
+ return { unusedConfidence: null, blastRadius: null, reversibility: null };
2115
+ }
2116
+ const o = v;
2117
+ return {
2118
+ unusedConfidence: str2(o.unused_confidence),
2119
+ blastRadius: str2(o.blast_radius),
2120
+ reversibility: str2(o.reversibility)
2121
+ };
2122
+ }
2123
+ function parseUsageEvidence(v) {
2124
+ if (!v || typeof v !== "object" || Array.isArray(v)) return {};
2125
+ const out = {};
2126
+ for (const signal of EVIDENCE_SIGNALS) {
2127
+ const raw = v[signal];
2128
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) continue;
2129
+ const o = raw;
2130
+ out[signal] = {
2131
+ status: str2(o.status) ?? "unknown",
2132
+ quality: str2(o.quality) ?? "unknown",
2133
+ detail: str2(o.detail)
2134
+ };
2135
+ }
2136
+ return out;
2137
+ }
2138
+ function parseSoftDeprecation(v) {
2139
+ if (!v || typeof v !== "object" || Array.isArray(v)) return null;
2140
+ const o = v;
2141
+ const windowRaw = o.observation_window_days;
2142
+ const window = typeof windowRaw === "number" && Number.isFinite(windowRaw) && windowRaw >= 0 ? Math.floor(windowRaw) : null;
2143
+ const exitCriteria = Array.isArray(o.exit_criteria) ? o.exit_criteria.map((c) => {
2144
+ if (typeof c === "string") return c.trim() ? { description: c.trim(), met: false } : null;
2145
+ if (c && typeof c === "object" && !Array.isArray(c)) {
2146
+ const co = c;
2147
+ const description = str2(co.description) ?? str2(co.criterion);
2148
+ if (!description) return null;
2149
+ return { description, met: co.met === true };
2150
+ }
2151
+ return null;
2152
+ }).filter((c) => Boolean(c)) : [];
2153
+ return {
2154
+ strategy: str2(o.strategy),
2155
+ mechanism: str2(o.mechanism),
2156
+ startedAt: str2(o.started_at),
2157
+ observationWindowDays: window,
2158
+ exitCriteria
2159
+ };
2160
+ }
2161
+ function parseEnvironments(v) {
2162
+ if (!v || typeof v !== "object" || Array.isArray(v)) return {};
2163
+ const out = {};
2164
+ for (const env of ENVIRONMENTS) {
2165
+ const s = str2(v[env]);
2166
+ if (s) out[env] = s;
2167
+ }
2168
+ return out;
2169
+ }
2170
+ function parseTarget(raw) {
2171
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
2172
+ const o = raw;
2173
+ const id = str2(o.id);
2174
+ if (!id) return null;
2175
+ return {
2176
+ id,
2177
+ type: str2(o.type) ?? "other",
2178
+ locator: str2(o.locator),
2179
+ title: str2(o.title),
2180
+ lifecycle: str2(o.lifecycle) ?? "candidate",
2181
+ environments: parseEnvironments(o.environments),
2182
+ assessment: parseAssessment(o.assessment),
2183
+ usageEvidence: parseUsageEvidence(o.usage_evidence),
2184
+ dependsOnRemoval: strArray2(o.depends_on_removal),
2185
+ resource: str2(o.resource),
2186
+ module: str2(o.module),
2187
+ softDeprecation: parseSoftDeprecation(o.soft_deprecation)
2188
+ };
2189
+ }
2190
+ function parseTargets(v) {
2191
+ if (!Array.isArray(v)) return [];
2192
+ const out = [];
2193
+ for (const raw of v) {
2194
+ const t = parseTarget(raw);
2195
+ if (t) out.push(t);
2196
+ }
2197
+ return out;
2198
+ }
2199
+ function lifecycleCountsOf(targets) {
2200
+ const counts = {};
2201
+ for (const t of targets) counts[t.lifecycle] = (counts[t.lifecycle] ?? 0) + 1;
2202
+ return counts;
2203
+ }
2204
+ function purposeFromBody2(body) {
2205
+ const m = body.match(/^#{1,2}\s+Purpose\s*\n+([\s\S]*?)(?=\n#{1,2}\s|\s*$)/m);
2206
+ const text2 = m ? m[1].trim() : "";
2207
+ return text2 || null;
2208
+ }
2209
+ function getDeprecationPlans(dir) {
2210
+ return discoverKnowledge(dir).filter((a) => a.type === DEPRECATION_ARTIFACT_TYPE).map((a) => {
2211
+ const fm = a.rawFrontmatter;
2212
+ const targets = parseTargets(fm.targets);
2213
+ return {
2214
+ id: a.id || str2(fm.id) || a.title,
2215
+ title: a.title || str2(fm.title) || a.id,
2216
+ path: a.relPath,
2217
+ status: str2(fm.status),
2218
+ targetCount: targets.length,
2219
+ lifecycleCounts: lifecycleCountsOf(targets)
2220
+ };
2221
+ }).sort((x, y) => x.id.localeCompare(y.id));
2222
+ }
2223
+ function getDeprecationPlan(dir, id) {
2224
+ const match = discoverKnowledge(dir).find(
2225
+ (a) => a.type === DEPRECATION_ARTIFACT_TYPE && (a.id === id || a.title === id)
2226
+ );
2227
+ if (!match) return null;
2228
+ const raw = readFile(match.filePath);
2229
+ const parsed = matter5(raw);
2230
+ const fm = parsed.data ?? {};
2231
+ const body = parsed.content.trim();
2232
+ const targets = parseTargets(fm.targets);
2233
+ return {
2234
+ id: str2(fm.id) ?? match.id,
2235
+ title: str2(fm.title) ?? match.title,
2236
+ path: match.relPath,
2237
+ status: str2(fm.status),
2238
+ targetCount: targets.length,
2239
+ lifecycleCounts: lifecycleCountsOf(targets),
2240
+ purpose: str2(fm.purpose) ?? purposeFromBody2(body),
2241
+ targets,
2242
+ markdownBody: body
2243
+ };
2244
+ }
2245
+ function validateTarget(target) {
2246
+ const findings = [];
2247
+ const at = target.id;
2248
+ if (!isValidTargetType(String(target.type))) {
2249
+ findings.push({ severity: "error", target: at, message: `Unknown target type: ${target.type}` });
2250
+ }
2251
+ if (!isValidLifecycleState(String(target.lifecycle))) {
2252
+ findings.push({ severity: "error", target: at, message: `Unknown lifecycle state: ${target.lifecycle}` });
2253
+ }
2254
+ if (!target.locator) {
2255
+ findings.push({ severity: "warning", target: at, message: "Target has no locator \u2014 it may be ambiguous." });
2256
+ }
2257
+ for (const [env, state] of Object.entries(target.environments)) {
2258
+ if (!isValidEnvironmentState(String(state))) {
2259
+ findings.push({ severity: "error", target: at, message: `Unknown environment state for ${env}: ${state}` });
2260
+ }
2261
+ }
2262
+ const prodActive = target.environments.production === "active";
2263
+ if (target.lifecycle === "completed") {
2264
+ const stillActive = ENVIRONMENTS.filter((e) => target.environments[e] === "active");
2265
+ if (stillActive.length > 0) {
2266
+ findings.push({
2267
+ severity: "error",
2268
+ target: at,
2269
+ message: `Target is 'completed' but still active in: ${stillActive.join(", ")}.`
2270
+ });
2271
+ }
2272
+ }
2273
+ if ((target.lifecycle === "production-changed" || target.lifecycle === "observing") && prodActive) {
2274
+ findings.push({
2275
+ severity: "error",
2276
+ target: at,
2277
+ message: `Target is '${target.lifecycle}' but production is still 'active'.`
2278
+ });
2279
+ }
2280
+ return findings;
2281
+ }
2282
+ function validatePlan(plan) {
2283
+ const findings = [];
2284
+ const ids = new Set(plan.targets.map((t) => t.id));
2285
+ for (const t of plan.targets) {
2286
+ findings.push(...validateTarget(t));
2287
+ for (const dep of t.dependsOnRemoval) {
2288
+ if (!ids.has(dep)) {
2289
+ findings.push({
2290
+ severity: "error",
2291
+ target: t.id,
2292
+ message: `depends_on_removal references unknown target: ${dep}`
2293
+ });
2294
+ }
2295
+ if (dep === t.id) {
2296
+ findings.push({ severity: "error", target: t.id, message: "Target depends on its own removal." });
2297
+ }
2298
+ }
2299
+ }
2300
+ return findings;
2301
+ }
2302
+
2007
2303
  // src/core/graph.ts
2008
2304
  var KNOWLEDGE2 = "knowledge";
2009
2305
  var RESOURCE_ROLE_EDGE = {
@@ -2048,9 +2344,9 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
2048
2344
  ];
2049
2345
  const presentLayers = [];
2050
2346
  for (const layer of layerDocs) {
2051
- const path5 = layer.files.map((f) => `${KNOWLEDGE2}/${f}`).find((rel) => exists(join(dir, rel)));
2052
- if (path5) {
2053
- addNode({ id: layer.id, type: layer.type, label: layer.label, path: path5 });
2347
+ const path6 = layer.files.map((f) => `${KNOWLEDGE2}/${f}`).find((rel) => exists(join(dir, rel)));
2348
+ if (path6) {
2349
+ addNode({ id: layer.id, type: layer.type, label: layer.label, path: path6 });
2054
2350
  presentLayers.push(layer.id);
2055
2351
  }
2056
2352
  }
@@ -2108,6 +2404,33 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
2108
2404
  addEdge(modId, resId, "depends_on");
2109
2405
  }
2110
2406
  }
2407
+ for (const summary of getDeprecationPlans(dir)) {
2408
+ const plan = getDeprecationPlan(dir, summary.id);
2409
+ if (!plan) continue;
2410
+ const planId = `deprecation-plan:${plan.id}`;
2411
+ addNode({ id: planId, type: "deprecation-plan", label: `${plan.id} ${plan.title}`.trim(), path: plan.path, status: plan.status ?? void 0 });
2412
+ for (const target of plan.targets) {
2413
+ const targetId = `deprecation-target:${target.id}`;
2414
+ addNode({ id: targetId, type: "deprecation-target", label: target.title ? `${target.id} ${target.title}` : target.id, path: plan.path, status: target.lifecycle });
2415
+ addEdge(planId, targetId, "targets");
2416
+ if (target.module) {
2417
+ const moduleId = `module:${target.module}`;
2418
+ addNode({ id: moduleId, type: "module", label: target.module });
2419
+ addEdge(targetId, moduleId, "targets");
2420
+ }
2421
+ if (target.resource) {
2422
+ const resourceId = `resource:${target.resource}`;
2423
+ const title = resourceTitleById.get(target.resource);
2424
+ addNode({ id: resourceId, type: "project-resource", label: title ? `${target.resource} ${title}` : target.resource });
2425
+ addEdge(targetId, resourceId, "targets");
2426
+ }
2427
+ for (const dependency of target.dependsOnRemoval) {
2428
+ const dependencyId = `deprecation-target:${dependency}`;
2429
+ addNode({ id: dependencyId, type: "deprecation-target", label: dependency });
2430
+ addEdge(targetId, dependencyId, "depends_on_removal");
2431
+ }
2432
+ }
2433
+ }
2111
2434
  for (const wi of selectedWIs) {
2112
2435
  const id = wi.id || wi.title;
2113
2436
  if (!id || !id.trim()) continue;
@@ -2138,6 +2461,11 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
2138
2461
  addNode({ id: resId, type: "project-resource", label: title ? `${rel.id} ${title}`.trim() : rel.id });
2139
2462
  addEdge(wiNodeId, resId, RESOURCE_ROLE_EDGE[rel.role] ?? "uses");
2140
2463
  }
2464
+ for (const ref of parseWorkItemDeprecationTargets(wi.rawFrontmatter)) {
2465
+ const targetId = `deprecation-target:${ref.target}`;
2466
+ addNode({ id: targetId, type: "deprecation-target", label: ref.target });
2467
+ addEdge(wiNodeId, targetId, "targets");
2468
+ }
2141
2469
  for (const dec of wi.decisions) {
2142
2470
  if (!dec || !dec.trim()) continue;
2143
2471
  const adrId = `adr:${dec}`;
@@ -2412,7 +2740,7 @@ function loadGraphHints(dir) {
2412
2740
  }
2413
2741
 
2414
2742
  // src/services/installed-skills.ts
2415
- import matter5 from "gray-matter";
2743
+ import matter6 from "gray-matter";
2416
2744
  var SKILLS_DIR = join("knowledge", "skills");
2417
2745
  function discoverInstalledSkills(dir) {
2418
2746
  const base = join(dir, SKILLS_DIR);
@@ -2422,7 +2750,7 @@ function discoverInstalledSkills(dir) {
2422
2750
  const skillFile = join(base, entry, "skill.md");
2423
2751
  if (!isFile(skillFile)) continue;
2424
2752
  try {
2425
- const { data } = matter5(readFile(skillFile));
2753
+ const { data } = matter6(readFile(skillFile));
2426
2754
  if (data.type && String(data.type) !== "skill") continue;
2427
2755
  const id = String(data.id ?? entry);
2428
2756
  out.push({
@@ -3424,13 +3752,13 @@ function meaningful(text2) {
3424
3752
  });
3425
3753
  }
3426
3754
  function readPocSummary(dir) {
3427
- const path5 = join(dir, POC_ARTIFACT_PATH);
3428
- if (!exists(path5)) {
3755
+ const path6 = join(dir, POC_ARTIFACT_PATH);
3756
+ if (!exists(path6)) {
3429
3757
  return { exists: false, hypothesisDefined: false, successCriteriaCount: 0, constraintsDefined: false, nonGoalsDefined: false, conclusion: "pending" };
3430
3758
  }
3431
3759
  let markdown = "";
3432
3760
  try {
3433
- markdown = readFile(path5);
3761
+ markdown = readFile(path6);
3434
3762
  } catch {
3435
3763
  return { exists: false, hypothesisDefined: false, successCriteriaCount: 0, constraintsDefined: false, nonGoalsDefined: false, conclusion: "pending" };
3436
3764
  }
@@ -3449,7 +3777,7 @@ function readPocSummary(dir) {
3449
3777
 
3450
3778
  // src/core/poc-report.ts
3451
3779
  import { createHash } from "crypto";
3452
- import matter6 from "gray-matter";
3780
+ import matter7 from "gray-matter";
3453
3781
  var POC_REPORT_PREFIX = "poc-report-v";
3454
3782
  var SECRET_LINE = /(^|\s)(?:[A-Z][A-Z0-9_]*(?:TOKEN|SECRET|PASSWORD|API_KEY|PRIVATE_KEY)|(?:token|secret|password|api[_-]?key))\s*[:=]\s*\S+/i;
3455
3783
  var reportName = /^poc-report-v(\d{3,})\.md$/;
@@ -3465,11 +3793,11 @@ function redactSecrets(value) {
3465
3793
  return line.replace(/([:=]\s*)\S+.*/, "$1[redacted]");
3466
3794
  }).join("\n");
3467
3795
  }
3468
- function source(dir, path5, kind) {
3469
- const absolute = join(dir, path5);
3796
+ function source(dir, path6, kind) {
3797
+ const absolute = join(dir, path6);
3470
3798
  if (!exists(absolute)) return null;
3471
3799
  const raw = readFile(absolute);
3472
- return { path: posix(path5), kind, digest: sha(raw), content: redactSecrets(raw) };
3800
+ return { path: posix(path6), kind, digest: sha(raw), content: redactSecrets(raw) };
3473
3801
  }
3474
3802
  function reportFiles(dir) {
3475
3803
  const delivery = join(dir, "knowledge", "delivery");
@@ -3477,7 +3805,7 @@ function reportFiles(dir) {
3477
3805
  const match = name.match(reportName);
3478
3806
  if (!match) return [];
3479
3807
  try {
3480
- const parsed = matter6(readFile(join(delivery, name)));
3808
+ const parsed = matter7(readFile(join(delivery, name)));
3481
3809
  const fingerprint = typeof parsed.data.source_fingerprint === "string" ? parsed.data.source_fingerprint : "";
3482
3810
  const manifest = parsed.data.source_manifest;
3483
3811
  const sourceManifest = manifest && typeof manifest === "object" && !Array.isArray(manifest) ? Object.fromEntries(Object.entries(manifest).filter(([, digest]) => typeof digest === "string")) : {};
@@ -3509,9 +3837,9 @@ function buildPocReportContext(dir) {
3509
3837
  };
3510
3838
  }
3511
3839
  const sources = [];
3512
- const add = (path5, kind) => {
3513
- if (sources.some((item2) => item2.path === posix(path5))) return;
3514
- const item = source(dir, path5, kind);
3840
+ const add = (path6, kind) => {
3841
+ if (sources.some((item2) => item2.path === posix(path6))) return;
3842
+ const item = source(dir, path6, kind);
3515
3843
  if (item) sources.push(item);
3516
3844
  };
3517
3845
  add(POC_ARTIFACT_PATH, "poc");
@@ -3539,7 +3867,7 @@ function buildPocReportContext(dir) {
3539
3867
  const sourceFingerprint = sha(sources.map((item) => `${item.path}\0${item.digest}`).join("\n"));
3540
3868
  const status = !latestReport ? "missing" : latestReport.sourceFingerprint === sourceFingerprint ? "current" : "stale";
3541
3869
  const currentManifest = Object.fromEntries(sources.map((item) => [item.path, item.digest]));
3542
- const changesSinceLatest = status === "stale" ? [.../* @__PURE__ */ new Set([...Object.keys(currentManifest), ...Object.keys(latestReport?.sourceManifest ?? {})])].filter((path5) => currentManifest[path5] !== latestReport?.sourceManifest[path5]).sort() : [];
3870
+ const changesSinceLatest = status === "stale" ? [.../* @__PURE__ */ new Set([...Object.keys(currentManifest), ...Object.keys(latestReport?.sourceManifest ?? {})])].filter((path6) => currentManifest[path6] !== latestReport?.sourceManifest[path6]).sort() : [];
3543
3871
  const sourceList = sources.map((item) => `- ${item.path} (${item.kind})`).join("\n") || "- No sources selected.";
3544
3872
  return {
3545
3873
  eligible: true,
@@ -3576,7 +3904,7 @@ function canonicalReport(context, proposal) {
3576
3904
  source_manifest: Object.fromEntries(context.sources.map((item) => [item.path, item.digest]))
3577
3905
  };
3578
3906
  if (supersedes) data.supersedes = supersedes;
3579
- return matter6.stringify(redactSecrets(proposal).trimEnd() + "\n", data);
3907
+ return matter7.stringify(redactSecrets(proposal).trimEnd() + "\n", data);
3580
3908
  }
3581
3909
  function persistPocReport(dir, proposal, opts = {}) {
3582
3910
  const context = buildPocReportContext(dir);
@@ -3715,10 +4043,10 @@ function resolveNextStep(dir, now = /* @__PURE__ */ new Date()) {
3715
4043
  const q = (rel) => analyzeKnowledgeArtifact(dir, rel);
3716
4044
  const resolveAgent = (agent) => {
3717
4045
  const file = agent.endsWith(".md") ? agent : `${agent}.md`;
3718
- const path5 = agentInstallPath(file);
3719
- const installed = isFile(join(dir, path5));
4046
+ const path6 = agentInstallPath(file);
4047
+ const installed = isFile(join(dir, path6));
3720
4048
  const group = agentGroupOf(file);
3721
- return { agentPath: path5, agentInstalled: installed, installCommand: installed ? void 0 : `kaddo add agents --group ${group}` };
4049
+ return { agentPath: path6, agentInstalled: installed, installCommand: installed ? void 0 : `kaddo add agents --group ${group}` };
3722
4050
  };
3723
4051
  const moduleRepo = isModule(config);
3724
4052
  const coreRepo = isCore(config);
@@ -4148,7 +4476,7 @@ function deriveDeliveryCompletedStatus(dir) {
4148
4476
  }
4149
4477
 
4150
4478
  // src/core/assets.ts
4151
- import matter7 from "gray-matter";
4479
+ import matter8 from "gray-matter";
4152
4480
 
4153
4481
  // src/core/version.ts
4154
4482
  import { fileURLToPath } from "url";
@@ -7459,7 +7787,7 @@ function canonicalSkills() {
7459
7787
  }
7460
7788
  function versionOf(content) {
7461
7789
  try {
7462
- const v = matter7(content).data.version;
7790
+ const v = matter8(content).data.version;
7463
7791
  return v === void 0 || v === null ? null : String(v);
7464
7792
  } catch {
7465
7793
  return null;
@@ -8218,7 +8546,7 @@ function buildProjectRoute(dir) {
8218
8546
  }
8219
8547
 
8220
8548
  // src/core/metadata-health.ts
8221
- import matter8 from "gray-matter";
8549
+ import matter9 from "gray-matter";
8222
8550
  var KNOWLEDGE_FILES2 = [
8223
8551
  "knowledge/business/business.md",
8224
8552
  "knowledge/product/product.md",
@@ -8238,7 +8566,7 @@ function analyzeMetadataHealth(dir) {
8238
8566
  let data;
8239
8567
  try {
8240
8568
  const raw = readFile(p);
8241
- data = matter8(raw).data;
8569
+ data = matter9(raw).data;
8242
8570
  } catch {
8243
8571
  continue;
8244
8572
  }
@@ -8270,7 +8598,7 @@ function analyzeMetadataHealth(dir) {
8270
8598
  if (isFile(p) && entry.endsWith(".md")) {
8271
8599
  try {
8272
8600
  const raw = readFile(p);
8273
- const fm = matter8(raw).data;
8601
+ const fm = matter9(raw).data;
8274
8602
  if (fm.status === "done") {
8275
8603
  const rel = p.replace(dir + "/", "").replace(dir + "\\", "").replace(/\\/g, "/");
8276
8604
  findings.push({
@@ -8634,7 +8962,7 @@ function buildProjectExplanation(dir) {
8634
8962
  // src/core/resource-write.ts
8635
8963
  import fs2 from "fs";
8636
8964
  import path2 from "path";
8637
- import matter9 from "gray-matter";
8965
+ import matter10 from "gray-matter";
8638
8966
  var RESOURCES_DIR = "knowledge/tech/resources";
8639
8967
  var ResourceWriteError = class extends Error {
8640
8968
  constructor(code, message) {
@@ -8714,7 +9042,7 @@ function buildFrontmatter(id, input, base = {}) {
8714
9042
  return data;
8715
9043
  }
8716
9044
  function serialize(data, body) {
8717
- return matter9.stringify(`
9045
+ return matter10.stringify(`
8718
9046
  ${body.trim()}
8719
9047
  `, data);
8720
9048
  }
@@ -8754,7 +9082,7 @@ function updateResource(dir, id, input) {
8754
9082
  throw new ResourceWriteError("VALIDATION_FAILED", findings.filter((f) => f.level === "error").map((f) => f.message).join("; "));
8755
9083
  }
8756
9084
  const raw = readFile(match.filePath);
8757
- const parsed = matter9(raw);
9085
+ const parsed = matter10(raw);
8758
9086
  const base = parsed.data ?? {};
8759
9087
  const data = buildFrontmatter(match.id || id, input, base);
8760
9088
  let body = parsed.content.trim();
@@ -9025,7 +9353,7 @@ function analyzeCrossRepoEvidence(input) {
9025
9353
  }
9026
9354
 
9027
9355
  // src/core/work-items.ts
9028
- import matter10 from "gray-matter";
9356
+ import matter11 from "gray-matter";
9029
9357
 
9030
9358
  // src/core/system-topology.ts
9031
9359
  import { parse as parseYaml8, stringify as stringifyYaml5 } from "yaml";
@@ -9397,6 +9725,8 @@ function getWorkItem(dir, workItemId) {
9397
9725
  markdownBody: body.trim(),
9398
9726
  // External systems this WI relates to (WI-030), separate from affectedModules (code).
9399
9727
  resources: parseWorkItemResources(fm),
9728
+ // Deprecation Targets this WI retires (WI-050), referenced not copied.
9729
+ deprecationTargets: parseWorkItemDeprecationTargets(fm),
9400
9730
  ...parseSystemImpact(dir, fm)
9401
9731
  };
9402
9732
  return { ...detail, refinement: computeRefinementStatus(detail) };
@@ -9405,8 +9735,8 @@ function parseGraphReason(v) {
9405
9735
  if (!v || typeof v !== "object") return null;
9406
9736
  const o = v;
9407
9737
  const relationship = typeof o.relationship === "string" && o.relationship.trim() ? o.relationship.trim() : null;
9408
- const path5 = Array.isArray(o.path) ? o.path.map(String).filter(Boolean) : [];
9409
- return relationship || path5.length ? { relationship, path: path5 } : null;
9738
+ const path6 = Array.isArray(o.path) ? o.path.map(String).filter(Boolean) : [];
9739
+ return relationship || path6.length ? { relationship, path: path6 } : null;
9410
9740
  }
9411
9741
  function parseExplain(o) {
9412
9742
  const refs = Array.isArray(o.evidence) ? o.evidence : Array.isArray(o.evidence_refs) ? o.evidence_refs : [];
@@ -9461,7 +9791,7 @@ function parseOriginalSnapshot(fm) {
9461
9791
  function readBody(filePath) {
9462
9792
  try {
9463
9793
  const raw = readFile(filePath);
9464
- return matter10(raw).content;
9794
+ return matter11(raw).content;
9465
9795
  } catch {
9466
9796
  return "";
9467
9797
  }
@@ -9628,7 +9958,7 @@ function parseRelatedKnowledge(fm, knowledgeById) {
9628
9958
  import fs4 from "fs";
9629
9959
  import path4 from "path";
9630
9960
  import crypto2 from "crypto";
9631
- import matter11 from "gray-matter";
9961
+ import matter12 from "gray-matter";
9632
9962
 
9633
9963
  // src/core/knowledge-levels.ts
9634
9964
  var WORK_ITEM_TYPES2 = ["feature", "bugfix", "hotfix", "spike", "chore"];
@@ -10035,7 +10365,7 @@ function applyFrontmatter(data, input) {
10035
10365
  return next;
10036
10366
  }
10037
10367
  function serialize2(data, body) {
10038
- return matter11.stringify(`
10368
+ return matter12.stringify(`
10039
10369
  ${body.trim()}
10040
10370
  `, data);
10041
10371
  }
@@ -10094,7 +10424,7 @@ function toInput(data, content) {
10094
10424
  function getWorkItemForEdit(dir, id) {
10095
10425
  const { filePath, relPath } = findArtifact(dir, id);
10096
10426
  const raw = readFile(filePath);
10097
- const { data, content } = matter11(raw);
10427
+ const { data, content } = matter12(raw);
10098
10428
  const status = lifecycleStateOf({ status: String(data.status ?? ""), filePath });
10099
10429
  const input = toInput(data, content);
10100
10430
  const editable = EDITABLE_STATES.includes(status);
@@ -10187,7 +10517,7 @@ function updateWorkItem(dir, id, input, expectedRevision) {
10187
10517
  if (revisionOf(raw) !== expectedRevision) {
10188
10518
  throw new WorkItemWriteError("WORK_ITEM_CONFLICT", "This Work Item changed outside Kaddo Admin. Reload the latest version before saving.");
10189
10519
  }
10190
- const { data, content } = matter11(raw);
10520
+ const { data, content } = matter12(raw);
10191
10521
  const status = lifecycleStateOf({ status: String(data.status ?? ""), filePath });
10192
10522
  if (!EDITABLE_STATES.includes(status)) {
10193
10523
  throw new WorkItemWriteError("WORK_ITEM_NOT_EDITABLE", `A ${status} Work Item cannot be edited. Reopen it as Draft first.`);
@@ -10201,7 +10531,7 @@ function updateWorkItem(dir, id, input, expectedRevision) {
10201
10531
  function validateWorkItem(dir, id) {
10202
10532
  const { filePath } = findArtifact(dir, id);
10203
10533
  const raw = readFile(filePath);
10204
- const { data, content } = matter11(raw);
10534
+ const { data, content } = matter12(raw);
10205
10535
  const input = toInput(data, content);
10206
10536
  const findings = [];
10207
10537
  const modules = validModuleIds(dir);
@@ -10254,7 +10584,7 @@ function transitionWorkItem(dir, id, to, expectedRevision) {
10254
10584
  if (revisionOf(raw) !== expectedRevision) {
10255
10585
  throw new WorkItemWriteError("WORK_ITEM_CONFLICT", "This Work Item changed outside Kaddo Admin. Reload the latest version before continuing.");
10256
10586
  }
10257
- const { data, content } = matter11(raw);
10587
+ const { data, content } = matter12(raw);
10258
10588
  const from = lifecycleStateOf({ status: String(data.status ?? ""), filePath });
10259
10589
  if (!(ALLOWED[from] ?? []).includes(to)) {
10260
10590
  throw new WorkItemWriteError("INVALID_TRANSITION", `Cannot transition a ${from} Work Item to ${to}.`);
@@ -10520,16 +10850,16 @@ function findSystemPaths(dir, source2, target, opts = {}) {
10520
10850
  out.get(r.source).push(r.target);
10521
10851
  }
10522
10852
  const paths = [];
10523
- const walk = (node, path5) => {
10853
+ const walk = (node, path6) => {
10524
10854
  if (paths.length >= 20) return;
10525
- if (node === target && path5.length > 1) {
10526
- paths.push([...path5]);
10855
+ if (node === target && path6.length > 1) {
10856
+ paths.push([...path6]);
10527
10857
  return;
10528
10858
  }
10529
- if (path5.length > maxDepth) return;
10859
+ if (path6.length > maxDepth) return;
10530
10860
  for (const nxt of out.get(node) ?? []) {
10531
- if (path5.includes(nxt)) continue;
10532
- walk(nxt, [...path5, nxt]);
10861
+ if (path6.includes(nxt)) continue;
10862
+ walk(nxt, [...path6, nxt]);
10533
10863
  }
10534
10864
  };
10535
10865
  walk(source2, [source2]);
@@ -10554,14 +10884,14 @@ function getImpactCandidates(dir, seedIds, opts = {}) {
10554
10884
  existing.reason.push(reason);
10555
10885
  continue;
10556
10886
  }
10557
- const path5 = findSystemPaths(dir, seed, n.id, { maxDepth: opts.maxDepth ?? DEFAULT_MAX_DEPTH })[0];
10887
+ const path6 = findSystemPaths(dir, seed, n.id, { maxDepth: opts.maxDepth ?? DEFAULT_MAX_DEPTH })[0];
10558
10888
  candidates.set(n.id, {
10559
10889
  nodeId: n.id,
10560
10890
  label: n.label,
10561
10891
  kind: n.type,
10562
10892
  ...n.moduleId ? { moduleId: n.moduleId } : {},
10563
10893
  reason: [reason],
10564
- ...path5 ? { graphPath: path5.map((id) => byId.get(id)?.label ?? id) } : {},
10894
+ ...path6 ? { graphPath: path6.map((id) => byId.get(id)?.label ?? id) } : {},
10565
10895
  ...n.implementationRefs?.length ? { implementationRefs: n.implementationRefs } : {},
10566
10896
  ...n.knowledgeRefs?.length ? { knowledgeRefs: n.knowledgeRefs } : {},
10567
10897
  status: "candidate",
@@ -10721,6 +11051,235 @@ function buildRefinementHandoff(dir, workItemId) {
10721
11051
  };
10722
11052
  }
10723
11053
 
11054
+ // src/core/deprecation-observation.ts
11055
+ var DAY_MS = 24 * 60 * 60 * 1e3;
11056
+ function addDaysIso(startIso, days) {
11057
+ const start = Date.parse(startIso);
11058
+ if (Number.isNaN(start)) return null;
11059
+ return new Date(start + days * DAY_MS).toISOString().slice(0, 10);
11060
+ }
11061
+ function observationStatus(target, now = /* @__PURE__ */ new Date()) {
11062
+ const sd = target.softDeprecation;
11063
+ const reasons = [];
11064
+ if (!sd) {
11065
+ return {
11066
+ declared: false,
11067
+ windowElapsed: false,
11068
+ windowEndsAt: null,
11069
+ criteriaTotal: 0,
11070
+ criteriaMet: 0,
11071
+ allCriteriaMet: false,
11072
+ eligibleForRemovalReview: false,
11073
+ reasons: ["No soft-deprecation/observation window declared \u2014 not eligible for removal review."]
11074
+ };
11075
+ }
11076
+ const criteriaTotal = sd.exitCriteria.length;
11077
+ const criteriaMet = sd.exitCriteria.filter((c) => c.met).length;
11078
+ const allCriteriaMet = criteriaTotal > 0 && criteriaMet === criteriaTotal;
11079
+ let windowElapsed = false;
11080
+ let windowEndsAt = null;
11081
+ if (sd.startedAt && sd.observationWindowDays != null) {
11082
+ windowEndsAt = addDaysIso(sd.startedAt, sd.observationWindowDays);
11083
+ if (windowEndsAt) {
11084
+ windowElapsed = now.getTime() >= Date.parse(windowEndsAt);
11085
+ }
11086
+ }
11087
+ if (!sd.startedAt) reasons.push("Observation has not started (no started_at).");
11088
+ else if (sd.observationWindowDays == null) reasons.push("No observation_window_days declared.");
11089
+ else if (!windowElapsed) reasons.push(`Observation window not elapsed (ends ${windowEndsAt ?? "unknown"}).`);
11090
+ if (criteriaTotal === 0) reasons.push("No exit criteria declared.");
11091
+ else if (!allCriteriaMet) reasons.push(`Exit criteria not all met (${criteriaMet}/${criteriaTotal}).`);
11092
+ const eligibleForRemovalReview = windowElapsed && allCriteriaMet;
11093
+ if (eligibleForRemovalReview) {
11094
+ reasons.length = 0;
11095
+ reasons.push("Observation window elapsed and all exit criteria met \u2014 eligible for removal REVIEW (human decision).");
11096
+ }
11097
+ return {
11098
+ declared: true,
11099
+ windowElapsed,
11100
+ windowEndsAt,
11101
+ criteriaTotal,
11102
+ criteriaMet,
11103
+ allCriteriaMet,
11104
+ eligibleForRemovalReview,
11105
+ reasons
11106
+ };
11107
+ }
11108
+ function targetsPastObservation(plan, now = /* @__PURE__ */ new Date()) {
11109
+ return plan.targets.filter((t) => observationStatus(t, now).eligibleForRemovalReview).map((t) => t.id);
11110
+ }
11111
+ function isRetainedOutcome(target) {
11112
+ return String(target.lifecycle) === "deprecated-retained";
11113
+ }
11114
+ function environmentSummary(target) {
11115
+ const perEnvironment = {};
11116
+ for (const env of ENVIRONMENTS) perEnvironment[env] = String(target.environments[env] ?? "active");
11117
+ return {
11118
+ perEnvironment,
11119
+ removedInDevTest: perEnvironment.development === "removed" && perEnvironment.test === "removed",
11120
+ productionActive: perEnvironment.production === "active"
11121
+ };
11122
+ }
11123
+
11124
+ // src/core/deprecation-intelligence.ts
11125
+ function isStrongNoUsage(sig) {
11126
+ return sig.status === "no-usage" && (sig.quality === "observed-fact" || sig.quality === "human-confirmed");
11127
+ }
11128
+ function deriveUnusedConfidence(evidence) {
11129
+ const present = EVIDENCE_SIGNALS.map((name) => ({ name, sig: evidence[name] })).filter(
11130
+ (e) => Boolean(e.sig)
11131
+ );
11132
+ const usageFound = present.filter((e) => e.sig.status === "usage-found");
11133
+ if (usageFound.length > 0) {
11134
+ return {
11135
+ confidence: "in-use",
11136
+ requiresHumanConfirmation: false,
11137
+ rationale: [`Usage found via: ${usageFound.map((e) => e.name).join(", ")}.`]
11138
+ };
11139
+ }
11140
+ const strong = present.filter((e) => isStrongNoUsage(e.sig));
11141
+ const unknown = present.filter((e) => e.sig.status === "unknown");
11142
+ const notEvaluated = EVIDENCE_SIGNALS.filter(
11143
+ (name) => !evidence[name] || evidence[name]?.status === "not-evaluated"
11144
+ );
11145
+ const rationale = [];
11146
+ if (strong.length > 0) rationale.push(`No usage observed via: ${strong.map((e) => e.name).join(", ")}.`);
11147
+ if (unknown.length > 0) {
11148
+ rationale.push(`Unknown (looked but could not determine): ${unknown.map((e) => e.name).join(", ")} \u2014 NOT treated as no-usage.`);
11149
+ }
11150
+ if (notEvaluated.length > 0) {
11151
+ rationale.push(`Not evaluated: ${notEvaluated.join(", ")} \u2014 absence of a reference is not evidence of no usage.`);
11152
+ }
11153
+ let confidence;
11154
+ if (strong.length === 0) {
11155
+ confidence = "insufficient-evidence";
11156
+ } else if (unknown.length > 0) {
11157
+ confidence = "medium";
11158
+ } else if (strong.length >= 2) {
11159
+ confidence = "high";
11160
+ } else {
11161
+ confidence = "medium";
11162
+ }
11163
+ return { confidence, requiresHumanConfirmation: true, rationale };
11164
+ }
11165
+ function deriveRemovalWaves(plan) {
11166
+ const ids = new Set(plan.targets.map((t) => t.id));
11167
+ const deps = /* @__PURE__ */ new Map();
11168
+ const blocked = [];
11169
+ for (const t of plan.targets) {
11170
+ const resolved = [];
11171
+ for (const d of t.dependsOnRemoval) {
11172
+ if (d === t.id) {
11173
+ blocked.push({ target: t.id, reason: "Target depends on its own removal." });
11174
+ continue;
11175
+ }
11176
+ if (!ids.has(d)) {
11177
+ blocked.push({ target: t.id, reason: `depends_on_removal references unknown target: ${d}.` });
11178
+ continue;
11179
+ }
11180
+ resolved.push(d);
11181
+ }
11182
+ deps.set(t.id, resolved);
11183
+ }
11184
+ const placed = /* @__PURE__ */ new Set();
11185
+ const waves = [];
11186
+ let remaining = plan.targets.map((t) => t.id);
11187
+ while (remaining.length > 0) {
11188
+ const wave = remaining.filter((id) => (deps.get(id) ?? []).every((d) => placed.has(d)));
11189
+ if (wave.length === 0) break;
11190
+ for (const id of wave) placed.add(id);
11191
+ waves.push(wave);
11192
+ remaining = remaining.filter((id) => !placed.has(id));
11193
+ }
11194
+ for (const id of remaining) {
11195
+ blocked.push({ target: id, reason: "Involved in a removal dependency cycle \u2014 cannot be ordered." });
11196
+ }
11197
+ return { waves, blocked };
11198
+ }
11199
+ var RETIRED_STATES = /* @__PURE__ */ new Set([
11200
+ "removed-devtest",
11201
+ "production-changed",
11202
+ "observing",
11203
+ "completed",
11204
+ "deprecated-retained"
11205
+ ]);
11206
+ function isRetiredLifecycle(state) {
11207
+ return RETIRED_STATES.has(state);
11208
+ }
11209
+ function targetsEligibleForRemoval(plan) {
11210
+ const byId = new Map(plan.targets.map((t) => [t.id, t]));
11211
+ return plan.targets.filter((t) => !isRetiredLifecycle(String(t.lifecycle))).filter(
11212
+ (t) => t.dependsOnRemoval.every((d) => {
11213
+ const dep = byId.get(d);
11214
+ return dep ? isRetiredLifecycle(String(dep.lifecycle)) : false;
11215
+ })
11216
+ ).map((t) => t.id);
11217
+ }
11218
+ function planIntelligence(plan) {
11219
+ const waves = deriveRemovalWaves(plan);
11220
+ const eligible = new Set(targetsEligibleForRemoval(plan));
11221
+ const byId = new Map(plan.targets.map((t) => [t.id, t]));
11222
+ const targets = plan.targets.map((t) => ({
11223
+ id: t.id,
11224
+ unused: deriveUnusedConfidence(t.usageEvidence),
11225
+ eligibleForRemovalReview: eligible.has(t.id),
11226
+ blockedBy: t.dependsOnRemoval.filter((d) => {
11227
+ const dep = byId.get(d);
11228
+ return !dep || !isRetiredLifecycle(String(dep.lifecycle));
11229
+ }),
11230
+ observation: observationStatus(t)
11231
+ }));
11232
+ return { waves, eligible: [...eligible], targets };
11233
+ }
11234
+ function proposeWorkItemCandidates(plan) {
11235
+ const { waves } = deriveRemovalWaves(plan);
11236
+ const byId = new Map(plan.targets.map((t) => [t.id, t]));
11237
+ const candidates = [];
11238
+ waves.forEach((waveIds, waveIndex) => {
11239
+ const wave = waveIndex + 1;
11240
+ const groups = /* @__PURE__ */ new Map();
11241
+ for (const id of waveIds) {
11242
+ const t = byId.get(id);
11243
+ if (!t) continue;
11244
+ const key = t.module;
11245
+ const list2 = groups.get(key) ?? [];
11246
+ list2.push(t);
11247
+ groups.set(key, list2);
11248
+ }
11249
+ const keys = [...groups.keys()].sort((a, b) => {
11250
+ if (a === null) return 1;
11251
+ if (b === null) return -1;
11252
+ return a.localeCompare(b);
11253
+ });
11254
+ for (const key of keys) {
11255
+ const targets = groups.get(key);
11256
+ const resources = [...new Set(targets.map((t) => t.resource).filter((r) => Boolean(r)))];
11257
+ candidates.push({
11258
+ wave,
11259
+ module: key,
11260
+ title: `${plan.id} wave ${wave}${key ? ` (${key})` : ""}: retire ${targets.map((t) => t.id).join(", ")}`,
11261
+ deprecationTargets: targets.map((t) => t.id),
11262
+ resources
11263
+ });
11264
+ }
11265
+ });
11266
+ return candidates;
11267
+ }
11268
+ var CANDIDATE_DISCOVERY_GUIDANCE = [
11269
+ "Propose deprecation candidates from multiple sources: static references (code/routes/UI/jobs),",
11270
+ "the System Graph (dependencies and blast radius), Legacy Knowledge (risks/unknowns/modernization",
11271
+ "candidates), Project Resources (databases/external systems and their boundaries), runtime evidence",
11272
+ "when telemetry exists, and database metadata when reachable.",
11273
+ "",
11274
+ "Rules:",
11275
+ "- Discovery is a PROPOSAL, not a materialization: never create or retire anything automatically.",
11276
+ "- Always explain WHY something is a candidate, citing the signal(s) observed.",
11277
+ "- Absence of a reference is NOT evidence of no usage. If a source cannot be evaluated, record it",
11278
+ " as not-evaluated/unknown and require human investigation \u2014 never collapse it to no-usage.",
11279
+ "- A modernization candidate is not automatically a deprecation target.",
11280
+ "- Soft deprecation precedes physical removal; order retirements by dependency, dependents first."
11281
+ ].join("\n");
11282
+
10724
11283
  // src/core/implementation-handoff.ts
10725
11284
  var WorkItemNotReadyError = class extends Error {
10726
11285
  constructor(workItemId, actualState) {
@@ -10752,6 +11311,16 @@ function buildImplementationHandoff(dir, workItemId) {
10752
11311
  const domains = match.domains;
10753
11312
  const scopeConfidence = match.scopeConfidence;
10754
11313
  const wiResources = parseWorkItemResources(match.rawFrontmatter);
11314
+ const wiDeprecationRefs = parseWorkItemDeprecationTargets(match.rawFrontmatter);
11315
+ const resolveTarget = (ref) => {
11316
+ const plans = ref.plan ? [getDeprecationPlan(dir, ref.plan)].filter(Boolean) : getDeprecationPlans(dir).map((p) => getDeprecationPlan(dir, p.id));
11317
+ for (const p of plans) {
11318
+ if (!p) continue;
11319
+ const t = p.targets.find((x) => x.id.toUpperCase() === ref.target.toUpperCase());
11320
+ if (t) return { planId: p.id, target: t };
11321
+ }
11322
+ return null;
11323
+ };
10755
11324
  const lines = [
10756
11325
  `Implement Work Item ${wiId} \u2014 "${wiTitle}" \u2014 in project "${projectName}" using Kaddo.`,
10757
11326
  "",
@@ -10876,6 +11445,48 @@ function buildImplementationHandoff(dir, workItemId) {
10876
11445
  "installed or connected. Do not execute any interface or migration without explicit human confirmation."
10877
11446
  );
10878
11447
  }
11448
+ if (wiDeprecationRefs.length > 0) {
11449
+ lines.push(
11450
+ "",
11451
+ "--- Relevant Deprecation Targets ---",
11452
+ "",
11453
+ "This Work Item is part of a Controlled Deprecation plan. It RETIRES the targets below. Soft",
11454
+ "deprecation precedes physical removal; in Dev/Test you may remove code/endpoints/dev-test data",
11455
+ "when the resource boundary allows and there is confirmation. A production change needs a Runbook",
11456
+ "and explicit human approval \u2014 never execute a destructive production operation autonomously."
11457
+ );
11458
+ for (const ref of wiDeprecationRefs) {
11459
+ const resolved = resolveTarget(ref);
11460
+ if (!resolved) {
11461
+ lines.push("", `- ${ref.target}${ref.plan ? ` (plan ${ref.plan})` : ""} \u2014 target not found in any Deprecation Plan.`);
11462
+ continue;
11463
+ }
11464
+ const { planId, target: t } = resolved;
11465
+ lines.push("", `- ${t.id} [${t.type}] \u2014 plan ${planId}, lifecycle: ${t.lifecycle}`);
11466
+ if (t.locator) lines.push(` locator: ${t.locator}`);
11467
+ const envs = Object.entries(t.environments).map(([e, s]) => `${e}=${s}`).join(" ");
11468
+ if (envs) lines.push(` environments: ${envs}`);
11469
+ const unused = deriveUnusedConfidence(t.usageEvidence);
11470
+ lines.push(` unused confidence: ${unused.confidence}${unused.requiresHumanConfirmation ? " (human confirmation required)" : ""}`);
11471
+ if (t.assessment.blastRadius) lines.push(` blast radius: ${t.assessment.blastRadius}`);
11472
+ if (t.assessment.reversibility) lines.push(` reversibility: ${t.assessment.reversibility}`);
11473
+ if (t.dependsOnRemoval.length > 0) lines.push(` depends_on_removal: ${t.dependsOnRemoval.join(", ")} (retire these first)`);
11474
+ if (t.resource) {
11475
+ const res = getResource(dir, t.resource);
11476
+ if (res) {
11477
+ const bounds = Object.entries(res.boundaries).map(([env, ops]) => `${env}: ${ops.join("/")}`).join(" \xB7 ");
11478
+ lines.push(` resource: ${res.id} \u2014 ${res.title}${bounds ? ` (boundaries \u2014 ${bounds})` : ""}`);
11479
+ } else {
11480
+ lines.push(` resource: ${t.resource} \u2014 definition not found under knowledge/tech/resources/.`);
11481
+ }
11482
+ }
11483
+ }
11484
+ lines.push(
11485
+ "",
11486
+ "Record what you actually retired as Evidence. Prepare a rollback for every change; for production,",
11487
+ "the rollback/abort path lives in the Runbook, not here."
11488
+ );
11489
+ }
10879
11490
  lines.push(
10880
11491
  "",
10881
11492
  "--- Implementation Plan ---",
@@ -10897,6 +11508,7 @@ function buildImplementationHandoff(dir, workItemId) {
10897
11508
  lifecycle,
10898
11509
  affectedModules,
10899
11510
  resources: wiResources,
11511
+ deprecationTargets: wiDeprecationRefs,
10900
11512
  domains,
10901
11513
  scopeConfidence,
10902
11514
  hasUnmaterializedDecisions: unmaterialized,
@@ -11133,7 +11745,7 @@ function deriveImplementationStatus(repos) {
11133
11745
  // src/core/work-item-import.ts
11134
11746
  import crypto3 from "crypto";
11135
11747
  import fs5 from "fs";
11136
- import matter12 from "gray-matter";
11748
+ import matter13 from "gray-matter";
11137
11749
  var MAX_INPUT_BYTES = 102400;
11138
11750
  var LIFECYCLE_FIELDS = /* @__PURE__ */ new Set([
11139
11751
  "id",
@@ -11155,7 +11767,7 @@ function detectFormat(raw) {
11155
11767
  if (!trimmed) throw new ImportError("EMPTY_INPUT", "Import content is empty.");
11156
11768
  if (trimmed.startsWith("---")) {
11157
11769
  try {
11158
- const { data } = matter12(trimmed);
11770
+ const { data } = matter13(trimmed);
11159
11771
  if (data && typeof data === "object" && Object.keys(data).length > 0) {
11160
11772
  const d = data;
11161
11773
  if (d.type === "work-item" || d.id && typeof d.id === "string" && /^WI-\d+/.test(d.id)) {
@@ -11177,7 +11789,7 @@ function parseContent(raw) {
11177
11789
  let bodyText = trimmed;
11178
11790
  if (format === "kaddo-frontmatter" || format === "markdown-frontmatter") {
11179
11791
  try {
11180
- const parsed = matter12(trimmed);
11792
+ const parsed = matter13(trimmed);
11181
11793
  frontmatterFields = parsed.data ?? {};
11182
11794
  bodyText = parsed.content.trim();
11183
11795
  } catch {
@@ -11274,7 +11886,7 @@ function findDuplicateByHash(dir, hash) {
11274
11886
  const raw = readFile(item.filePath);
11275
11887
  if (!raw) continue;
11276
11888
  try {
11277
- const { data } = matter12(raw);
11889
+ const { data } = matter13(raw);
11278
11890
  const source2 = data?.source;
11279
11891
  if (source2 && typeof source2 === "object" && !Array.isArray(source2)) {
11280
11892
  const s = source2;
@@ -11383,7 +11995,7 @@ var ImportError = class extends Error {
11383
11995
  };
11384
11996
 
11385
11997
  // src/services/integrations.ts
11386
- import matter13 from "gray-matter";
11998
+ import matter14 from "gray-matter";
11387
11999
  import { parse as parseYaml9, stringify as stringifyYaml6 } from "yaml";
11388
12000
 
11389
12001
  // ../integrations/src/errors.ts
@@ -12152,8 +12764,8 @@ async function handleJiraResponse(res) {
12152
12764
  }
12153
12765
  return await res.json();
12154
12766
  }
12155
- async function jiraFetch(baseUrl, path5, auth, timeoutMs, params) {
12156
- const url = new URL(path5, baseUrl + "/");
12767
+ async function jiraFetch(baseUrl, path6, auth, timeoutMs, params) {
12768
+ const url = new URL(path6, baseUrl + "/");
12157
12769
  if (params) for (const [k, v] of Object.entries(params)) url.searchParams.set(k, v);
12158
12770
  const controller = new AbortController();
12159
12771
  const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -12171,8 +12783,8 @@ async function jiraFetch(baseUrl, path5, auth, timeoutMs, params) {
12171
12783
  clearTimeout(timer);
12172
12784
  }
12173
12785
  }
12174
- async function jiraPost(baseUrl, path5, auth, timeoutMs, body) {
12175
- const url = new URL(path5, baseUrl + "/");
12786
+ async function jiraPost(baseUrl, path6, auth, timeoutMs, body) {
12787
+ const url = new URL(path6, baseUrl + "/");
12176
12788
  const controller = new AbortController();
12177
12789
  const timer = setTimeout(() => controller.abort(), timeoutMs);
12178
12790
  try {
@@ -12725,7 +13337,7 @@ function findLinkedWorkItem(dir, integrationId, externalId) {
12725
13337
  for (const art of discoverWorkItems(dir)) {
12726
13338
  let data;
12727
13339
  try {
12728
- data = matter13(readFile(art.filePath)).data;
13340
+ data = matter14(readFile(art.filePath)).data;
12729
13341
  } catch {
12730
13342
  continue;
12731
13343
  }
@@ -12741,7 +13353,7 @@ function buildImportIndex(dir) {
12741
13353
  for (const art of discoverWorkItems(dir)) {
12742
13354
  let data;
12743
13355
  try {
12744
- data = matter13(readFile(art.filePath)).data;
13356
+ data = matter14(readFile(art.filePath)).data;
12745
13357
  } catch {
12746
13358
  continue;
12747
13359
  }
@@ -12917,7 +13529,7 @@ function getStatus(dir) {
12917
13529
  }
12918
13530
 
12919
13531
  // src/core/initiative-write.ts
12920
- import matter14 from "gray-matter";
13532
+ import matter15 from "gray-matter";
12921
13533
  var WORK_ITEMS_DIR2 = "knowledge/delivery/work-items";
12922
13534
  var DRAFT_DIR = `${WORK_ITEMS_DIR2}/draft`;
12923
13535
  var ROADMAP_PATH2 = "knowledge/delivery/roadmap.md";
@@ -13030,7 +13642,7 @@ function buildInitiativeContent(id, input) {
13030
13642
  if (input.priority) data.priority = input.priority;
13031
13643
  if (input.source) data.source = input.source;
13032
13644
  if (input.sourceId) data.source_id = input.sourceId;
13033
- return matter14.stringify("\n" + (input.body ?? defaultBody(input.title.trim())), data);
13645
+ return matter15.stringify("\n" + (input.body ?? defaultBody(input.title.trim())), data);
13034
13646
  }
13035
13647
  function createInitiative(dir, input) {
13036
13648
  if (!input.title?.trim()) throw new InitiativeWriteError("Initiative title is required.");
@@ -13054,10 +13666,10 @@ function transitionInitiative(dir, id, to) {
13054
13666
  throw new InitiativeWriteError(`Invalid transition ${ini.status} \u2192 ${to}.`);
13055
13667
  }
13056
13668
  const raw = readFile(ini.filePath);
13057
- const { data, content } = matter14(raw, {});
13669
+ const { data, content } = matter15(raw, {});
13058
13670
  data.status = to;
13059
13671
  if (to === "completed") data.completed_at = today();
13060
- const newContent = matter14.stringify(content, data);
13672
+ const newContent = matter15.stringify(content, data);
13061
13673
  writeFile(ini.filePath, newContent);
13062
13674
  const updated = parseInitiative(dir, ini.filePath, newContent);
13063
13675
  if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after transition.");
@@ -13067,7 +13679,7 @@ function addCandidate(dir, id, candidate) {
13067
13679
  const ini = getInitiative(dir, id);
13068
13680
  if (!ini) throw new InitiativeWriteError(`Initiative ${id} not found.`);
13069
13681
  const raw = readFile(ini.filePath);
13070
- const { data, content } = matter14(raw, {});
13682
+ const { data, content } = matter15(raw, {});
13071
13683
  const existing = Array.isArray(data.candidates) ? data.candidates : [];
13072
13684
  const fallbackId = `WI-CANDIDATE-${String(existing.length + 1).padStart(3, "0")}`;
13073
13685
  const normalized = normalizeCandidate(candidate, fallbackId);
@@ -13075,7 +13687,7 @@ function addCandidate(dir, id, candidate) {
13075
13687
  throw new InitiativeWriteError(`Candidate ${normalized.id} already exists in ${id}.`);
13076
13688
  }
13077
13689
  data.candidates = [...existing, candidateToData(normalized)];
13078
- const newContent = matter14.stringify(content, data);
13690
+ const newContent = matter15.stringify(content, data);
13079
13691
  writeFile(ini.filePath, newContent);
13080
13692
  const updated = parseInitiative(dir, ini.filePath, newContent);
13081
13693
  if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after adding a candidate.");
@@ -13085,7 +13697,7 @@ function updateInitiative(dir, id, patch) {
13085
13697
  const ini = getInitiative(dir, id);
13086
13698
  if (!ini) throw new InitiativeWriteError(`Initiative ${id} not found.`);
13087
13699
  const raw = readFile(ini.filePath);
13088
- const { data, content } = matter14(raw, {});
13700
+ const { data, content } = matter15(raw, {});
13089
13701
  if (patch.title !== void 0) {
13090
13702
  if (!patch.title.trim()) throw new InitiativeWriteError("Initiative title cannot be empty.");
13091
13703
  data.title = patch.title.trim();
@@ -13095,7 +13707,7 @@ function updateInitiative(dir, id, patch) {
13095
13707
  if (patch.knowledgeLevel !== void 0) data.knowledge_level = patch.knowledgeLevel;
13096
13708
  if (patch.domains !== void 0) data.domains = patch.domains;
13097
13709
  if (patch.relatedCapabilities !== void 0) data.related_capabilities = patch.relatedCapabilities;
13098
- const newContent = matter14.stringify(content, data);
13710
+ const newContent = matter15.stringify(content, data);
13099
13711
  writeFile(ini.filePath, newContent);
13100
13712
  const updated = parseInitiative(dir, ini.filePath, newContent);
13101
13713
  if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after update.");
@@ -13113,10 +13725,10 @@ function addExternalLink(dir, id, link) {
13113
13725
  throw new InitiativeWriteError(`External link ${link.integration}:${link.externalId} already exists on ${id}.`);
13114
13726
  }
13115
13727
  const raw = readFile(ini.filePath);
13116
- const { data, content } = matter14(raw, {});
13728
+ const { data, content } = matter15(raw, {});
13117
13729
  const existing = Array.isArray(data.external_links) ? data.external_links : [];
13118
13730
  data.external_links = [...existing, externalLinkToData(link)];
13119
- const newContent = matter14.stringify(content, data);
13731
+ const newContent = matter15.stringify(content, data);
13120
13732
  writeFile(ini.filePath, newContent);
13121
13733
  const updated = parseInitiative(dir, ini.filePath, newContent);
13122
13734
  if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after adding an external link.");
@@ -13185,7 +13797,7 @@ function buildWorkItemContent(wiId, iniId, candidate) {
13185
13797
  "_What did we learn? Update after completion._",
13186
13798
  ""
13187
13799
  ].join("\n");
13188
- return matter14.stringify("\n" + body, data);
13800
+ return matter15.stringify("\n" + body, data);
13189
13801
  }
13190
13802
  function materializeCandidate(dir, id, candidateId) {
13191
13803
  const ini = getInitiative(dir, id);
@@ -13202,13 +13814,13 @@ function materializeCandidate(dir, id, candidateId) {
13202
13814
  ensureDir(join(dir, DRAFT_DIR));
13203
13815
  writeFile(join(dir, DRAFT_DIR, fileName), buildWorkItemContent(wiId, ini.id, candidate));
13204
13816
  const raw = readFile(ini.filePath);
13205
- const { data, content } = matter14(raw, {});
13817
+ const { data, content } = matter15(raw, {});
13206
13818
  const cands = Array.isArray(data.candidates) ? data.candidates : [];
13207
13819
  for (const c of cands) {
13208
13820
  if (c && typeof c === "object" && String(c.id) === candidateId) c.materialized_as = wiId;
13209
13821
  }
13210
13822
  data.candidates = cands;
13211
- const newContent = matter14.stringify(content, data);
13823
+ const newContent = matter15.stringify(content, data);
13212
13824
  writeFile(ini.filePath, newContent);
13213
13825
  const updated = parseInitiative(dir, ini.filePath, newContent);
13214
13826
  if (!updated) throw new InitiativeWriteError("Failed to parse the Initiative after materialization.");
@@ -13355,8 +13967,424 @@ function evaluateInitiativeCompletion(dir, ini) {
13355
13967
  reasons
13356
13968
  };
13357
13969
  }
13970
+
13971
+ // src/core/deprecation-write.ts
13972
+ import fs6 from "fs";
13973
+ import path5 from "path";
13974
+ import matter16 from "gray-matter";
13975
+ var DeprecationWriteError = class extends Error {
13976
+ constructor(code, message) {
13977
+ super(message);
13978
+ this.code = code;
13979
+ this.name = "DeprecationWriteError";
13980
+ }
13981
+ code;
13982
+ };
13983
+ function slug4(s) {
13984
+ return s.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60);
13985
+ }
13986
+ function atomicWrite4(filePath, content) {
13987
+ const tmp = `${filePath}.tmp-${process.pid}-${Date.now()}`;
13988
+ fs6.writeFileSync(tmp, content, "utf-8");
13989
+ fs6.renameSync(tmp, filePath);
13990
+ }
13991
+ function serialize3(data, body) {
13992
+ return matter16.stringify(`
13993
+ ${body.trim()}
13994
+ `, data);
13995
+ }
13996
+ function allPlanArtifacts(dir) {
13997
+ return discoverKnowledge(dir).filter((a) => a.type === DEPRECATION_ARTIFACT_TYPE);
13998
+ }
13999
+ function nextPlanId(dir, explicit) {
14000
+ if (explicit && explicit.trim()) return explicit.trim();
14001
+ let max = 0;
14002
+ for (const a of allPlanArtifacts(dir)) {
14003
+ const m = (a.id || "").match(/^DEP-(\d+)$/i);
14004
+ if (m) max = Math.max(max, parseInt(m[1], 10));
14005
+ }
14006
+ return `DEP-${String(max + 1).padStart(3, "0")}`;
14007
+ }
14008
+ function nextTargetId(targetIds) {
14009
+ let max = 0;
14010
+ for (const id of targetIds) {
14011
+ const m = id.match(/^DEP-TGT-(\d+)$/i);
14012
+ if (m) max = Math.max(max, parseInt(m[1], 10));
14013
+ }
14014
+ return `DEP-TGT-${String(max + 1).padStart(3, "0")}`;
14015
+ }
14016
+ function buildTargetRaw(input, base = {}) {
14017
+ const out = { ...base };
14018
+ if (input.id != null) out.id = input.id;
14019
+ if (input.type != null) out.type = input.type;
14020
+ if (input.locator != null) out.locator = input.locator;
14021
+ if (input.title != null) out.title = input.title;
14022
+ if (input.lifecycle != null) out.lifecycle = input.lifecycle;
14023
+ if (input.environments != null) out.environments = input.environments;
14024
+ if (input.assessment != null) {
14025
+ const a = { ...typeof base.assessment === "object" && base.assessment ? base.assessment : {} };
14026
+ if (input.assessment.unusedConfidence != null) a.unused_confidence = input.assessment.unusedConfidence;
14027
+ if (input.assessment.blastRadius != null) a.blast_radius = input.assessment.blastRadius;
14028
+ if (input.assessment.reversibility != null) a.reversibility = input.assessment.reversibility;
14029
+ out.assessment = a;
14030
+ }
14031
+ if (input.dependsOnRemoval != null) out.depends_on_removal = input.dependsOnRemoval;
14032
+ if (input.resource != null) out.resource = input.resource;
14033
+ if (input.module != null) out.module = input.module;
14034
+ return out;
14035
+ }
14036
+ function validateTargetInput(dir, raw) {
14037
+ const findings = [];
14038
+ const parsed = parseTarget(raw);
14039
+ if (!parsed) {
14040
+ findings.push({ level: "error", message: "A target id is required." });
14041
+ return findings;
14042
+ }
14043
+ for (const f of validateTarget(parsed)) {
14044
+ findings.push({ level: f.severity === "error" ? "error" : "warning", message: f.message });
14045
+ }
14046
+ const mapped = loadMappedModules(dir).map((m) => m.id);
14047
+ if (parsed.module && mapped.length > 0 && !mapped.includes(parsed.module)) {
14048
+ findings.push({ level: "warning", message: `Module "${parsed.module}" is not in .kaddo/modules.yml.` });
14049
+ }
14050
+ if (parsed.resource && !getResource(dir, parsed.resource)) {
14051
+ findings.push({ level: "warning", message: `Project Resource "${parsed.resource}" not found.` });
14052
+ }
14053
+ return findings;
14054
+ }
14055
+ function loadPlanRaw(dir, planId) {
14056
+ const match = allPlanArtifacts(dir).find((a) => a.id === planId || a.title === planId);
14057
+ if (!match) throw new DeprecationWriteError("NOT_FOUND", `Deprecation Plan "${planId}" not found.`);
14058
+ const parsed = matter16(readFile(match.filePath));
14059
+ const data = { ...parsed.data ?? {} };
14060
+ return { filePath: match.filePath, data, body: parsed.content.trim() };
14061
+ }
14062
+ function rawTargets(data) {
14063
+ return Array.isArray(data.targets) ? data.targets : [];
14064
+ }
14065
+ function createPlan(dir, input) {
14066
+ const title = (input.title ?? "").trim();
14067
+ if (!title) throw new DeprecationWriteError("INVALID_INPUT", "A plan title is required.");
14068
+ const existing = allPlanArtifacts(dir);
14069
+ if (input.id && existing.some((a) => (a.id || "").toUpperCase() === input.id.toUpperCase())) {
14070
+ throw new DeprecationWriteError("DUPLICATE", `A plan with id "${input.id}" already exists.`);
14071
+ }
14072
+ if (existing.some((a) => (a.title || "").toLowerCase() === title.toLowerCase())) {
14073
+ throw new DeprecationWriteError("DUPLICATE", `A plan titled "${title}" already exists.`);
14074
+ }
14075
+ const id = nextPlanId(dir, input.id);
14076
+ const data = {
14077
+ type: DEPRECATION_ARTIFACT_TYPE,
14078
+ id,
14079
+ title,
14080
+ status: (input.status ?? "draft").trim() || "draft",
14081
+ targets: []
14082
+ };
14083
+ const body = `# Purpose
14084
+
14085
+ ${(input.purpose ?? "").trim() || "TODO: describe what this plan retires and why."}`;
14086
+ const relPath = `${DEPRECATION_PLANS_DIR}/${id}-${slug4(title) || "plan"}.md`;
14087
+ const filePath = join(dir, relPath);
14088
+ if (exists(filePath)) throw new DeprecationWriteError("DUPLICATE", `Plan file already exists: ${relPath}`);
14089
+ ensureDir(path5.dirname(filePath));
14090
+ atomicWrite4(filePath, serialize3(data, body));
14091
+ return { id, path: relPath, findings: [] };
14092
+ }
14093
+ function addTarget(dir, planId, input) {
14094
+ const { filePath, data, body } = loadPlanRaw(dir, planId);
14095
+ const targets = rawTargets(data);
14096
+ const existingIds = targets.map((t) => String(t.id ?? ""));
14097
+ const targetId = (input.id ?? "").trim() || nextTargetId(existingIds);
14098
+ if (existingIds.some((id) => id.toUpperCase() === targetId.toUpperCase())) {
14099
+ throw new DeprecationWriteError("DUPLICATE", `Target "${targetId}" already exists in ${planId}.`);
14100
+ }
14101
+ const raw = buildTargetRaw({ ...input, id: targetId, lifecycle: input.lifecycle ?? "candidate" });
14102
+ const findings = validateTargetInput(dir, raw);
14103
+ if (findings.some((f) => f.level === "error")) {
14104
+ throw new DeprecationWriteError("VALIDATION_FAILED", findings.filter((f) => f.level === "error").map((f) => f.message).join("; "));
14105
+ }
14106
+ data.targets = [...targets, raw];
14107
+ atomicWrite4(filePath, serialize3(data, body));
14108
+ return { planId, targetId, path: `${DEPRECATION_PLANS_DIR}/${path5.basename(filePath)}`, findings };
14109
+ }
14110
+ function updateTarget(dir, planId, targetId, patch) {
14111
+ const { filePath, data, body } = loadPlanRaw(dir, planId);
14112
+ const targets = rawTargets(data);
14113
+ const idx = targets.findIndex((t) => String(t.id ?? "").toUpperCase() === targetId.toUpperCase());
14114
+ if (idx === -1) throw new DeprecationWriteError("NOT_FOUND", `Target "${targetId}" not found in ${planId}.`);
14115
+ const merged = buildTargetRaw({ ...patch, id: String(targets[idx].id) }, targets[idx]);
14116
+ const findings = validateTargetInput(dir, merged);
14117
+ if (findings.some((f) => f.level === "error")) {
14118
+ throw new DeprecationWriteError("VALIDATION_FAILED", findings.filter((f) => f.level === "error").map((f) => f.message).join("; "));
14119
+ }
14120
+ const next = [...targets];
14121
+ next[idx] = merged;
14122
+ data.targets = next;
14123
+ atomicWrite4(filePath, serialize3(data, body));
14124
+ return { planId, targetId: String(targets[idx].id), path: `${DEPRECATION_PLANS_DIR}/${path5.basename(filePath)}`, findings };
14125
+ }
14126
+ function removeTarget(dir, planId, targetId, opts = {}) {
14127
+ const { filePath, data, body } = loadPlanRaw(dir, planId);
14128
+ const targets = rawTargets(data);
14129
+ const exists2 = targets.some((t) => String(t.id ?? "").toUpperCase() === targetId.toUpperCase());
14130
+ if (!exists2) throw new DeprecationWriteError("NOT_FOUND", `Target "${targetId}" not found in ${planId}.`);
14131
+ const dependents = targets.filter((t) => (Array.isArray(t.depends_on_removal) ? t.depends_on_removal.map(String) : []).some((d) => d.toUpperCase() === targetId.toUpperCase())).map((t) => String(t.id));
14132
+ if (!opts.confirm) {
14133
+ return { removed: false, preview: { planId, targetId, dependents } };
14134
+ }
14135
+ data.targets = targets.filter((t) => String(t.id ?? "").toUpperCase() !== targetId.toUpperCase());
14136
+ atomicWrite4(filePath, serialize3(data, body));
14137
+ return { removed: true, path: `${DEPRECATION_PLANS_DIR}/${path5.basename(filePath)}` };
14138
+ }
14139
+
14140
+ // src/core/deprecation-runbook.ts
14141
+ import matter17 from "gray-matter";
14142
+ var PRODUCTION_RUNBOOK_ARTIFACT_TYPE = "production-runbook";
14143
+ var PRODUCTION_RUNBOOKS_DIR = "knowledge/delivery/runbooks";
14144
+ var RUNBOOK_SECTIONS = [
14145
+ "Purpose",
14146
+ "Preconditions",
14147
+ "Dependencies",
14148
+ "Backup/Recovery",
14149
+ "Impact",
14150
+ "Execution Order",
14151
+ "Commands",
14152
+ "Expected Results",
14153
+ "Validation",
14154
+ "Rollback",
14155
+ "Abort Conditions",
14156
+ "Observation Window",
14157
+ "Evidence",
14158
+ "Approval"
14159
+ ];
14160
+ var ProductionRunbookError = class extends Error {
14161
+ constructor(message) {
14162
+ super(message);
14163
+ this.name = "ProductionRunbookError";
14164
+ }
14165
+ };
14166
+ function stringValue(value) {
14167
+ return typeof value === "string" && value.trim() ? value.trim() : null;
14168
+ }
14169
+ function slug5(value) {
14170
+ return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "production-change";
14171
+ }
14172
+ function nextRunbookNumber(dir) {
14173
+ const root = join(dir, PRODUCTION_RUNBOOKS_DIR);
14174
+ return readDir(root).reduce((highest, name) => {
14175
+ const match = name.match(/^RB-(\d+)-.+\.md$/i);
14176
+ return match ? Math.max(highest, Number(match[1])) : highest;
14177
+ }, 0) + 1;
14178
+ }
14179
+ function runbookPath(dir, target) {
14180
+ const id = `RB-${String(nextRunbookNumber(dir)).padStart(3, "0")}`;
14181
+ return `${PRODUCTION_RUNBOOKS_DIR}/${id}-${slug5(target.title ?? target.id)}.md`;
14182
+ }
14183
+ function parseApproval(value) {
14184
+ const data = value && typeof value === "object" && !Array.isArray(value) ? value : {};
14185
+ const status = data.status === "approved" ? "approved" : "pending";
14186
+ return {
14187
+ required: data.required === true,
14188
+ status,
14189
+ approvedBy: stringValue(data.approved_by),
14190
+ approvedAt: stringValue(data.approved_at)
14191
+ };
14192
+ }
14193
+ function sectionPresent(body, section2) {
14194
+ const escaped = section2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace("/", "\\/");
14195
+ return new RegExp(`^##\\s+${escaped}\\s*$`, "mi").test(body);
14196
+ }
14197
+ function destructiveCommands(body) {
14198
+ const lines = body.split(/\r?\n/);
14199
+ return lines.filter((line) => /\b(drop|truncate|delete\s+from|alter\s+(table|database|schema)|create\s+or\s+replace)\b/i.test(line));
14200
+ }
14201
+ function relatedTargets(plan, target) {
14202
+ const ids = new Set(target.dependsOnRemoval);
14203
+ return plan.targets.filter((candidate) => ids.has(candidate.id));
14204
+ }
14205
+ function buildProductionRunbookContext(dir, planId, targetId) {
14206
+ const plan = getDeprecationPlan(dir, planId);
14207
+ if (!plan) throw new ProductionRunbookError(`Deprecation Plan "${planId}" not found.`);
14208
+ const target = plan.targets.find((candidate) => candidate.id === targetId);
14209
+ if (!target) throw new ProductionRunbookError(`Target "${targetId}" not found in ${plan.id}.`);
14210
+ const environment = environmentSummary(target);
14211
+ const dependencies = relatedTargets(plan, target);
14212
+ const blockers = [];
14213
+ if (!environment.removedInDevTest) blockers.push("Development and test must both be removed before preparing a production runbook.");
14214
+ if (target.lifecycle !== "production-ready") blockers.push(`Target lifecycle must be production-ready (current: ${target.lifecycle}).`);
14215
+ for (const dependency of dependencies) {
14216
+ if (!["completed", "deprecated-retained"].includes(String(dependency.lifecycle))) {
14217
+ blockers.push(`Dependency ${dependency.id} is not retired (current: ${dependency.lifecycle}).`);
14218
+ }
14219
+ }
14220
+ const path6 = runbookPath(dir, target);
14221
+ return {
14222
+ eligible: blockers.length === 0,
14223
+ plan: { id: plan.id, title: plan.title, purpose: plan.purpose },
14224
+ target,
14225
+ resource: target.resource ? getResource(dir, target.resource) : null,
14226
+ dependencies,
14227
+ blockers,
14228
+ nextPath: path6,
14229
+ nextStep: blockers.length > 0 ? "Resolve the listed safeguards; no production proposal can be persisted yet." : "Review the generated proposal, obtain human approval, execute manually, then record evidence and validate the observation window."
14230
+ };
14231
+ }
14232
+ function renderRunbook(context) {
14233
+ const target = context.target;
14234
+ const resource = context.resource;
14235
+ const dependencies = context.dependencies.length > 0 ? context.dependencies.map((item) => `- ${item.id}: ${item.title ?? item.locator ?? item.id}`).join("\n") : "- None declared.";
14236
+ const evidence = Object.entries(target.usageEvidence).map(([signal, value]) => `- ${signal}: ${value.status} (${value.quality})${value.detail ? ` \u2014 ${value.detail}` : ""}`).join("\n") || "- No usage evidence declared. Do not infer no usage.";
14237
+ const observation = observationStatus(target);
14238
+ const resourceBoundary = resource ? `- Resource: ${resource.id} (${resource.title})
14239
+ - Production boundary: ${(resource.boundaries.production ?? []).join(", ") || "not declared"}
14240
+ - Interfaces: ${resource.interfaces.map((item) => item.type).join(", ") || "not declared"}` : "- No Project Resource is linked to this target.";
14241
+ return [
14242
+ "# Production Runbook",
14243
+ "",
14244
+ "## Purpose",
14245
+ "",
14246
+ `Safely apply the approved production change for ${target.id} (${target.title ?? target.locator ?? target.id}) in ${context.plan.id}.`,
14247
+ "",
14248
+ "## Preconditions",
14249
+ "",
14250
+ "- [ ] Development and test are removed and verified.",
14251
+ "- [ ] A human has reviewed this proposal and explicitly approved the production window.",
14252
+ "- [ ] Required backups/recovery points are verified before any change.",
14253
+ "",
14254
+ "## Dependencies",
14255
+ "",
14256
+ dependencies,
14257
+ "",
14258
+ "## Backup/Recovery",
14259
+ "",
14260
+ "- [ ] Record the backup, snapshot, export, or recovery point identifier before execution.",
14261
+ "- [ ] Confirm the restoration owner and recovery procedure.",
14262
+ "",
14263
+ "## Impact",
14264
+ "",
14265
+ `- Target: ${target.type} at ${target.locator ?? "not declared"}.`,
14266
+ `- Assessment: blast radius=${target.assessment.blastRadius ?? "not evaluated"}; reversibility=${target.assessment.reversibility ?? "not evaluated"}.`,
14267
+ resourceBoundary,
14268
+ "",
14269
+ "## Execution Order",
14270
+ "",
14271
+ "1. Confirm approval and the production change window.",
14272
+ "2. Verify the backup/recovery point.",
14273
+ "3. Execute the reviewed command manually.",
14274
+ "4. Capture actual results and validate before continuing.",
14275
+ "",
14276
+ "## Commands",
14277
+ "",
14278
+ "> Kaddo never executes production commands. Add only human-reviewed commands here after approval; do not place unattended automation in this runbook.",
14279
+ "",
14280
+ "## Expected Results",
14281
+ "",
14282
+ "- The approved target changes only in production.",
14283
+ "- No unrelated dependency or resource boundary is changed.",
14284
+ "",
14285
+ "## Validation",
14286
+ "",
14287
+ "- [ ] Validate the expected result using the linked resource/interface.",
14288
+ "- [ ] Confirm no unexpected errors or consumer regressions.",
14289
+ "",
14290
+ "## Rollback",
14291
+ "",
14292
+ "- [ ] Stop the change and apply the documented recovery procedure if validation fails.",
14293
+ "- [ ] Record the rollback result in Evidence.",
14294
+ "",
14295
+ "## Abort Conditions",
14296
+ "",
14297
+ "- Abort if the backup/recovery point is missing or cannot be restored.",
14298
+ "- Abort if approval is absent, the production window changes, or validation reveals unexpected impact.",
14299
+ "",
14300
+ "## Observation Window",
14301
+ "",
14302
+ `- ${observation.declared ? `Existing observation: ${observation.reasons.join(" ")}` : "After the production change, declare the observation window and exit criteria."}`,
14303
+ "- After manual validation, progress the target through production-changed \u2192 observing \u2192 completed only when the declared criteria are met. Kaddo never advances this lifecycle automatically.",
14304
+ "",
14305
+ "## Evidence",
14306
+ "",
14307
+ evidence,
14308
+ "",
14309
+ "## Approval",
14310
+ "",
14311
+ "- Required: human approval before manual execution.",
14312
+ "- Status: pending.",
14313
+ "- Approved by: not recorded.",
14314
+ "- Approved at: not recorded.",
14315
+ ""
14316
+ ].join("\n");
14317
+ }
14318
+ function createProductionRunbook(dir, planId, targetId) {
14319
+ const context = buildProductionRunbookContext(dir, planId, targetId);
14320
+ if (!context.eligible) throw new ProductionRunbookError(context.blockers.join(" "));
14321
+ const path6 = context.nextPath;
14322
+ const id = path6.split("/").pop()?.match(/^(RB-\d+)-/)?.[1] ?? "";
14323
+ const content = matter17.stringify(renderRunbook(context), {
14324
+ id,
14325
+ type: PRODUCTION_RUNBOOK_ARTIFACT_TYPE,
14326
+ title: `Production runbook \u2014 ${context.target.title ?? context.target.id}`,
14327
+ deprecation_plan: context.plan.id,
14328
+ deprecation_target: context.target.id,
14329
+ resource: context.target.resource,
14330
+ approval: { required: true, status: "pending", approved_by: null, approved_at: null }
14331
+ });
14332
+ const absolute = join(dir, path6);
14333
+ if (exists(absolute)) throw new ProductionRunbookError(`Runbook already exists: ${path6}`);
14334
+ writeFile(absolute, content);
14335
+ return {
14336
+ id,
14337
+ title: `Production runbook \u2014 ${context.target.title ?? context.target.id}`,
14338
+ path: path6,
14339
+ planId: context.plan.id,
14340
+ targetId: context.target.id,
14341
+ approval: { required: true, status: "pending", approvedBy: null, approvedAt: null },
14342
+ markdownBody: renderRunbook(context)
14343
+ };
14344
+ }
14345
+ function getProductionRunbook(dir, id) {
14346
+ const root = join(dir, PRODUCTION_RUNBOOKS_DIR);
14347
+ for (const name of readDir(root)) {
14348
+ if (!name.toLowerCase().startsWith(`${id.toLowerCase()}-`) || !name.endsWith(".md")) continue;
14349
+ const path6 = `${PRODUCTION_RUNBOOKS_DIR}/${name}`;
14350
+ const parsed = matter17(readFile(join(dir, path6)));
14351
+ const data = parsed.data;
14352
+ if (data.type !== PRODUCTION_RUNBOOK_ARTIFACT_TYPE) continue;
14353
+ return {
14354
+ id: stringValue(data.id) ?? id,
14355
+ title: stringValue(data.title) ?? id,
14356
+ path: path6,
14357
+ planId: stringValue(data.deprecation_plan) ?? "",
14358
+ targetId: stringValue(data.deprecation_target) ?? "",
14359
+ approval: parseApproval(data.approval),
14360
+ markdownBody: parsed.content.trim()
14361
+ };
14362
+ }
14363
+ return null;
14364
+ }
14365
+ function validateProductionRunbook(runbook) {
14366
+ const findings = [];
14367
+ for (const section2 of RUNBOOK_SECTIONS) {
14368
+ if (!sectionPresent(runbook.markdownBody, section2)) findings.push({ level: "error", message: `Missing required section: ${section2}.` });
14369
+ }
14370
+ if (!runbook.approval.required) findings.push({ level: "error", message: "Human approval must be required for a production runbook." });
14371
+ const destructive = destructiveCommands(runbook.markdownBody);
14372
+ if (destructive.length > 0 && (runbook.approval.status !== "approved" || !runbook.approval.approvedBy || !runbook.approval.approvedAt)) {
14373
+ findings.push({ level: "error", message: "Destructive production commands require explicit human approval with approver and timestamp." });
14374
+ }
14375
+ if (destructive.length > 0) findings.push({ level: "warning", message: "Destructive commands are documentation only; Kaddo will never execute them." });
14376
+ return findings;
14377
+ }
13358
14378
  export {
14379
+ CANDIDATE_DISCOVERY_GUIDANCE,
13359
14380
  CURRENT_CONSENT_VERSION,
14381
+ DEPRECATION_ARTIFACT_TYPE,
14382
+ DEPRECATION_PLANS_DIR,
14383
+ DeprecationWriteError,
14384
+ ENVIRONMENTS,
14385
+ ENVIRONMENT_STATES,
14386
+ EVIDENCE_QUALITIES,
14387
+ EVIDENCE_SIGNALS,
13360
14388
  INITIATIVES_DIR,
13361
14389
  INITIATIVE_STATES,
13362
14390
  INITIATIVE_TRANSITIONS,
@@ -13366,20 +14394,30 @@ export {
13366
14394
  InitiativeWriteError,
13367
14395
  IntegrationError,
13368
14396
  IntegrationServiceError,
14397
+ LIFECYCLE_STATES2 as LIFECYCLE_STATES,
14398
+ LIFECYCLE_TRANSITIONS,
13369
14399
  POC_ARTIFACT_PATH,
13370
14400
  POC_REPORT_PREFIX,
14401
+ PRODUCTION_RUNBOOKS_DIR,
14402
+ PRODUCTION_RUNBOOK_ARTIFACT_TYPE,
14403
+ ProductionRunbookError,
13371
14404
  RESOURCE_ARTIFACT_TYPE,
13372
14405
  RESOURCE_ROLES,
13373
14406
  RESOURCE_TYPES,
14407
+ RUNBOOK_SECTIONS,
13374
14408
  ResourceWriteError,
14409
+ SOFT_DEPRECATION_STRATEGIES,
14410
+ TARGET_TYPES,
13375
14411
  TOPOLOGY_FILE,
13376
14412
  TopologyWriteError,
14413
+ USAGE_STATUSES,
13377
14414
  WorkItemNotFoundError,
13378
14415
  WorkItemNotInProgressError,
13379
14416
  WorkItemNotReadyError,
13380
14417
  WorkItemWriteError,
13381
14418
  addCandidate,
13382
14419
  addExternalLink,
14420
+ addTarget,
13383
14421
  analyzeCrossRepoEvidence,
13384
14422
  analyzeInitiative,
13385
14423
  analyzeScopeCoverage,
@@ -13388,6 +14426,7 @@ export {
13388
14426
  buildImplementationHandoff,
13389
14427
  buildImportIndex,
13390
14428
  buildPocReportContext,
14429
+ buildProductionRunbookContext,
13391
14430
  buildProjectExplanation,
13392
14431
  buildProjectRoute,
13393
14432
  buildReadinessReport,
@@ -13400,12 +14439,16 @@ export {
13400
14439
  consentNotice,
13401
14440
  createInitiative,
13402
14441
  createIntegration,
14442
+ createPlan,
14443
+ createProductionRunbook,
13403
14444
  createResource,
13404
14445
  createWorkItem,
13405
14446
  cwd,
13406
14447
  deferConsent,
13407
14448
  deleteIntegration,
13408
14449
  deleteResource,
14450
+ deriveRemovalWaves,
14451
+ deriveUnusedConfidence,
13409
14452
  detectFormat,
13410
14453
  disableIntegration,
13411
14454
  discoverExternalWorkItems,
@@ -13413,6 +14456,7 @@ export {
13413
14456
  discoverKnowledge,
13414
14457
  discoverWorkItems,
13415
14458
  enableIntegration,
14459
+ environmentSummary,
13416
14460
  evaluateCompletion,
13417
14461
  evaluateInitiativeCompletion,
13418
14462
  exists,
@@ -13423,6 +14467,8 @@ export {
13423
14467
  findSystemPaths,
13424
14468
  getAvailableIntegrationTypes,
13425
14469
  getConsentState,
14470
+ getDeprecationPlan,
14471
+ getDeprecationPlans,
13426
14472
  getExternalWorkItem,
13427
14473
  getImpactCandidates,
13428
14474
  getInitiative,
@@ -13430,6 +14476,7 @@ export {
13430
14476
  getIntegration,
13431
14477
  getIntegrationFilters,
13432
14478
  getIntegrationSecretStatus,
14479
+ getProductionRunbook,
13433
14480
  getResource,
13434
14481
  getResourceReferences,
13435
14482
  getResources,
@@ -13449,9 +14496,15 @@ export {
13449
14496
  isDeferralActive,
13450
14497
  isInteractive,
13451
14498
  isModule,
14499
+ isRetainedOutcome,
14500
+ isRetiredLifecycle,
13452
14501
  isEnabled as isTelemetryEnabled,
14502
+ isValidEnvironmentState,
13453
14503
  isValidInitiativeStatus,
13454
14504
  isValidInitiativeTransition,
14505
+ isValidLifecycleState,
14506
+ isValidLifecycleTransition,
14507
+ isValidTargetType,
13455
14508
  join,
13456
14509
  knowledgeLayers,
13457
14510
  lifecycleCounts,
@@ -13464,23 +14517,36 @@ export {
13464
14517
  materializeCandidate,
13465
14518
  materializeRoadmapInitiative,
13466
14519
  nextInitiativeId,
14520
+ nextPlanId,
14521
+ nextTargetId,
14522
+ observationStatus,
13467
14523
  parseContent,
13468
14524
  parseInitiative,
13469
14525
  parseScope,
14526
+ parseSoftDeprecation,
13470
14527
  parseSuccessCriteria,
14528
+ parseTarget,
14529
+ parseTargets,
14530
+ parseUsageEvidence,
14531
+ parseWorkItemDeprecationTargets,
13471
14532
  parseWorkItemResources,
13472
14533
  persistConsent,
13473
14534
  persistPocReport,
14535
+ planIntelligence,
13474
14536
  previewImport,
13475
14537
  projectMode,
14538
+ proposeWorkItemCandidates,
13476
14539
  readFile,
13477
14540
  readPocSummary,
13478
14541
  redactSecrets,
13479
14542
  removeIntegrationSecret,
14543
+ removeTarget,
13480
14544
  searchSystemNodes,
13481
14545
  setIntegrationSecret,
13482
14546
  setProjectMode,
13483
14547
  suggestInitiativesForExternalItem,
14548
+ targetsEligibleForRemoval,
14549
+ targetsPastObservation,
13484
14550
  topologyRevision,
13485
14551
  transitionInitiative,
13486
14552
  transitionWorkItem,
@@ -13488,10 +14554,15 @@ export {
13488
14554
  updateIntegration,
13489
14555
  updateIntegrationFilters,
13490
14556
  updateResource,
14557
+ updateTarget,
13491
14558
  updateWorkItem,
13492
14559
  validateConfigAgainstSchema,
14560
+ validatePlan,
14561
+ validateProductionRunbook,
13493
14562
  validateResource,
13494
14563
  validateSystemTopology,
14564
+ validateTarget,
14565
+ validateTargetInput,
13495
14566
  validateTopologyProposal,
13496
14567
  validateWorkItem,
13497
14568
  verifyIntegration,