@iwsdk/cli 1.2.0-rc.0 → 1.2.0-rc.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 (103) hide show
  1. package/README.md +40 -13
  2. package/dist/agent-guidance/files/.agents/skills/iwsdk-build-model/SKILL.md +1 -1
  3. package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/SKILL.md +1 -1
  4. package/dist/agent-guidance/files/.agents/skills/iwsdk-debug/SKILL.md +1 -1
  5. package/dist/agent-guidance/files/.agents/skills/iwsdk-depth-occlusion/SKILL.md +1 -1
  6. package/dist/agent-guidance/files/.agents/skills/iwsdk-dev/SKILL.md +20 -1
  7. package/dist/agent-guidance/files/.agents/skills/iwsdk-dev/references/api-reference.md +2 -1
  8. package/dist/agent-guidance/files/.agents/skills/iwsdk-dev/references/headless-rendering.md +15 -1
  9. package/dist/agent-guidance/files/.agents/skills/iwsdk-dev/references/iterate.md +7 -3
  10. package/dist/agent-guidance/files/.agents/skills/iwsdk-glasses-test/SKILL.md +1 -1
  11. package/dist/agent-guidance/files/.agents/skills/iwsdk-grab/SKILL.md +1 -1
  12. package/dist/agent-guidance/files/.agents/skills/iwsdk-hosting/SKILL.md +3 -2
  13. package/dist/agent-guidance/files/.agents/skills/iwsdk-metavr-native/SKILL.md +216 -0
  14. package/dist/agent-guidance/files/.agents/skills/iwsdk-metavr-native/assets/iwn-host.mjs +71 -0
  15. package/dist/agent-guidance/files/.agents/skills/iwsdk-native-xr-test/SKILL.md +1 -1
  16. package/dist/agent-guidance/files/.agents/skills/iwsdk-offline/SKILL.md +217 -0
  17. package/dist/agent-guidance/files/.agents/skills/iwsdk-offline/assets/offline.ts.template +99 -0
  18. package/dist/agent-guidance/files/.agents/skills/iwsdk-offline/assets/sw.js.template +241 -0
  19. package/dist/agent-guidance/files/.agents/skills/iwsdk-offline/assets/write-service-worker.mjs.template +72 -0
  20. package/dist/agent-guidance/files/.agents/skills/iwsdk-offline/references/build-step.md +71 -0
  21. package/dist/agent-guidance/files/.agents/skills/iwsdk-offline/references/page.md +70 -0
  22. package/dist/agent-guidance/files/.agents/skills/iwsdk-offline/references/service-worker.md +107 -0
  23. package/dist/agent-guidance/files/.agents/skills/iwsdk-offline/references/testing.md +57 -0
  24. package/dist/agent-guidance/files/.agents/skills/iwsdk-physics/SKILL.md +1 -1
  25. package/dist/agent-guidance/files/.agents/skills/iwsdk-physics/references/tuning-and-config.md +1 -0
  26. package/dist/agent-guidance/files/.agents/skills/iwsdk-physics/references/workflows.md +9 -3
  27. package/dist/agent-guidance/files/.agents/skills/iwsdk-pwa-packaging/SKILL.md +18 -3
  28. package/dist/agent-guidance/files/.agents/skills/iwsdk-pwa-packaging/references/manifest-and-icons.md +1 -1
  29. package/dist/agent-guidance/files/.agents/skills/iwsdk-pwa-packaging/references/troubleshooting.md +30 -0
  30. package/dist/agent-guidance/files/.agents/skills/iwsdk-ray/SKILL.md +1 -1
  31. package/dist/agent-guidance/files/.agents/skills/iwsdk-ui/SKILL.md +12 -5
  32. package/dist/agent-guidance/files/.agents/skills/iwsdk-upgrade/SKILL.md +1 -1
  33. package/dist/agent-guidance/files/.claude/agents/iwsdk-project-code-reviewer.md +1 -1
  34. package/dist/agent-guidance/files/.claude/rules/assets-and-manifest.md +1 -1
  35. package/dist/agent-guidance/files/.claude/rules/ecs-api.md +1 -1
  36. package/dist/agent-guidance/files/.claude/rules/scene-json.md +1 -1
  37. package/dist/agent-guidance/files/.claude/rules/uikitml.md +1 -1
  38. package/dist/agent-guidance/files/.claude/settings.json +2 -0
  39. package/dist/agent-guidance/files/.claude/skills/iwsdk-build-model/SKILL.md +1 -1
  40. package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/SKILL.md +1 -1
  41. package/dist/agent-guidance/files/.claude/skills/iwsdk-debug/SKILL.md +1 -1
  42. package/dist/agent-guidance/files/.claude/skills/iwsdk-depth-occlusion/SKILL.md +1 -1
  43. package/dist/agent-guidance/files/.claude/skills/iwsdk-dev/SKILL.md +20 -1
  44. package/dist/agent-guidance/files/.claude/skills/iwsdk-dev/references/api-reference.md +2 -1
  45. package/dist/agent-guidance/files/.claude/skills/iwsdk-dev/references/headless-rendering.md +15 -1
  46. package/dist/agent-guidance/files/.claude/skills/iwsdk-dev/references/iterate.md +7 -3
  47. package/dist/agent-guidance/files/.claude/skills/iwsdk-glasses-test/SKILL.md +1 -1
  48. package/dist/agent-guidance/files/.claude/skills/iwsdk-grab/SKILL.md +1 -1
  49. package/dist/agent-guidance/files/.claude/skills/iwsdk-hosting/SKILL.md +3 -2
  50. package/dist/agent-guidance/files/.claude/skills/iwsdk-metavr-native/SKILL.md +216 -0
  51. package/dist/agent-guidance/files/.claude/skills/iwsdk-metavr-native/assets/iwn-host.mjs +71 -0
  52. package/dist/agent-guidance/files/.claude/skills/iwsdk-native-xr-test/SKILL.md +1 -1
  53. package/dist/agent-guidance/files/.claude/skills/iwsdk-offline/SKILL.md +217 -0
  54. package/dist/agent-guidance/files/.claude/skills/iwsdk-offline/assets/offline.ts.template +99 -0
  55. package/dist/agent-guidance/files/.claude/skills/iwsdk-offline/assets/sw.js.template +241 -0
  56. package/dist/agent-guidance/files/.claude/skills/iwsdk-offline/assets/write-service-worker.mjs.template +72 -0
  57. package/dist/agent-guidance/files/.claude/skills/iwsdk-offline/references/build-step.md +71 -0
  58. package/dist/agent-guidance/files/.claude/skills/iwsdk-offline/references/page.md +70 -0
  59. package/dist/agent-guidance/files/.claude/skills/iwsdk-offline/references/service-worker.md +107 -0
  60. package/dist/agent-guidance/files/.claude/skills/iwsdk-offline/references/testing.md +57 -0
  61. package/dist/agent-guidance/files/.claude/skills/iwsdk-physics/SKILL.md +1 -1
  62. package/dist/agent-guidance/files/.claude/skills/iwsdk-physics/references/tuning-and-config.md +1 -0
  63. package/dist/agent-guidance/files/.claude/skills/iwsdk-physics/references/workflows.md +9 -3
  64. package/dist/agent-guidance/files/.claude/skills/iwsdk-pwa-packaging/SKILL.md +18 -3
  65. package/dist/agent-guidance/files/.claude/skills/iwsdk-pwa-packaging/references/manifest-and-icons.md +1 -1
  66. package/dist/agent-guidance/files/.claude/skills/iwsdk-pwa-packaging/references/troubleshooting.md +30 -0
  67. package/dist/agent-guidance/files/.claude/skills/iwsdk-ray/SKILL.md +1 -1
  68. package/dist/agent-guidance/files/.claude/skills/iwsdk-ui/SKILL.md +12 -5
  69. package/dist/agent-guidance/files/.claude/skills/iwsdk-upgrade/SKILL.md +1 -1
  70. package/dist/agent-guidance/files/.cursor/rules/assets-and-manifest.mdc +1 -1
  71. package/dist/agent-guidance/files/.cursor/rules/ecs-api.mdc +1 -1
  72. package/dist/agent-guidance/files/.cursor/rules/scene-json.mdc +1 -1
  73. package/dist/agent-guidance/files/.cursor/rules/uikitml.mdc +1 -1
  74. package/dist/agent-guidance/files/.github/instructions/assets-and-manifest.instructions.md +1 -1
  75. package/dist/agent-guidance/files/.github/instructions/ecs-api.instructions.md +1 -1
  76. package/dist/agent-guidance/files/.github/instructions/scene-json.instructions.md +1 -1
  77. package/dist/agent-guidance/files/.github/instructions/uikitml.instructions.md +1 -1
  78. package/dist/agent-guidance/files/AGENTS.md +10 -1
  79. package/dist/agent-guidance/files/public/scenes/AGENTS.md +1 -1
  80. package/dist/agent-guidance/files/public/ui/AGENTS.md +1 -1
  81. package/dist/agent-guidance/files/src/AGENTS.md +1 -1
  82. package/dist/agent-guidance/manifest.json +142 -12
  83. package/dist/agent-guidance.d.ts +31 -4
  84. package/dist/agent-guidance.d.ts.map +1 -1
  85. package/dist/agent-guidance.js +269 -60
  86. package/dist/agent-guidance.js.map +1 -1
  87. package/dist/cli.js +1128 -131
  88. package/dist/cli.js.map +1 -1
  89. package/dist/commands/upgrade.d.ts +87 -0
  90. package/dist/commands/upgrade.d.ts.map +1 -1
  91. package/dist/guidance-refresh.d.ts +23 -3
  92. package/dist/guidance-refresh.d.ts.map +1 -1
  93. package/dist/help.d.ts.map +1 -1
  94. package/dist/index.d.ts.map +1 -1
  95. package/dist/index.js +1128 -131
  96. package/dist/index.js.map +1 -1
  97. package/dist/metavr-telemetry.d.ts +6 -0
  98. package/dist/metavr-telemetry.d.ts.map +1 -1
  99. package/dist/package-manager.d.ts +6 -0
  100. package/dist/package-manager.d.ts.map +1 -1
  101. package/dist/release-notes.json +183 -0
  102. package/dist/version.d.ts +1 -1
  103. package/package.json +1 -1
@@ -5,6 +5,7 @@
5
5
  * LICENSE file in the root directory of this source tree.
6
6
  */
7
7
  import type { CliOptions, CliSuccess, ResolvedCliIo } from '../cli-types.js';
8
+ import { type PackageManagerInfo } from '../package-manager.js';
8
9
  /** Packages published together (the fixed group in .changeset/config.json, minus private @iwsdk/reference-assets). */
9
10
  export declare const RELEASED_PACKAGES: string[];
10
11
  interface PackageBump {
@@ -46,6 +47,92 @@ export interface UpgradeResult {
46
47
  };
47
48
  manualSteps: string[];
48
49
  }
50
+ /**
51
+ * Thrown when the upgrade stops before writing anything; `code` becomes the
52
+ * error code of the CLI's JSON failure.
53
+ */
54
+ export declare class UpgradeError extends Error {
55
+ readonly code: 'release_not_on_registry';
56
+ readonly details: Record<string, unknown>;
57
+ constructor(message: string, code: 'release_not_on_registry', details: Record<string, unknown>);
58
+ }
59
+ /** Yarn in Yarn 2+ projects, which ignore .npmrc; npm everywhere else. */
60
+ export type RegistryClient = 'npm' | 'yarn';
61
+ /** How to ask the registry the install uses; see `registryLookup`. */
62
+ export interface RegistryLookup {
63
+ client: RegistryClient;
64
+ /** Where the client runs. */
65
+ cwd: string;
66
+ /** Flags for every npm call. */
67
+ npmArgs?: string[];
68
+ /**
69
+ * npm_config_* variables for every npm call: the registry and auth
70
+ * settings of an app's own .npmrc, which pnpm and Yarn 1 merge over the
71
+ * workspace root's.
72
+ */
73
+ env?: Record<string, string>;
74
+ /** A Yarn 1 project: Yarn, run here, names its registry; npm asks it. */
75
+ yarnClassicCwd?: string;
76
+ }
77
+ /** The fields of a published package.json that the upgrade reads. */
78
+ interface PublishedManifest {
79
+ version?: string;
80
+ dependencies?: Record<string, string>;
81
+ /** Every published version (npm is asked for it for core only). */
82
+ versions?: string[];
83
+ }
84
+ export type ReleaseCheck = {
85
+ status: 'found';
86
+ registry: string;
87
+ core?: PublishedManifest;
88
+ } | {
89
+ status: 'missing';
90
+ registry: string;
91
+ /** Each package the registry does not have at the version. */
92
+ missing: Array<{
93
+ /** `<name>@<version>`. */
94
+ spec: string;
95
+ /** npm's or Yarn's error. */
96
+ reason: string;
97
+ /** No such package, which a registry also answers when you may not access it. */
98
+ packageNotFound: boolean;
99
+ }>;
100
+ /** The registry is the one set for the @iwsdk scope. */
101
+ scoped: boolean;
102
+ } | {
103
+ status: 'unavailable';
104
+ registry: string | null;
105
+ reason: string;
106
+ };
107
+ /**
108
+ * Ask the registry for every package at `version` before anything is
109
+ * written, the way the install will ask it (see `registryLookup`). Says which
110
+ * registry it asks on `stderr`.
111
+ */
112
+ export declare function checkRegistry({ names, version, stderr, timeoutMs, ...lookup }: RegistryLookup & {
113
+ names: string[];
114
+ version: string;
115
+ stderr: NodeJS.WritableStream;
116
+ timeoutMs?: number;
117
+ }): Promise<ReleaseCheck>;
118
+ /**
119
+ * How to ask the registry the install will use. The install runs in the
120
+ * project directory.
121
+ * - npm installs there with the workspace root's .npmrc and ignores the
122
+ * project's own, so npm runs in the workspace root.
123
+ * - pnpm and Yarn 1 merge the project's own .npmrc over the workspace root's,
124
+ * setting by setting: a scope registry or a token only the root sets still
125
+ * applies. When both set the registry or auth, npm runs in the workspace
126
+ * root and gets the project's registry and auth settings as npm_config_*
127
+ * variables, which npm takes over any .npmrc (unless the environment
128
+ * already sets them, as pnpm and Yarn 1 then do too). Otherwise npm runs in
129
+ * whichever directory sets them, the root when neither does. npm gets
130
+ * --no-workspaces, so that it reads the .npmrc there and not that of a root
131
+ * whose package.json declares workspaces.
132
+ * - Yarn 1 also takes the registry from .yarnrc, so Yarn names it.
133
+ * - Yarn 2+ reads only .yarnrc.yml, and is asked itself.
134
+ */
135
+ export declare function registryLookup(projectRoot: string, info: PackageManagerInfo): RegistryLookup;
49
136
  export declare function handleUpgrade(options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<UpgradeResult>>;
50
137
  export {};
51
138
  //# sourceMappingURL=upgrade.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAoB7E,sHAAsH;AACtH,eAAO,MAAM,iBAAiB,UAS7B,CAAC;AAEF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,QAAQ,EACJ;QACE,MAAM,EAAE,QAAQ,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,GACD;QAAE,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAuMD,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAuPpC"}
1
+ {"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAO7E,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAU/B,sHAAsH;AACtH,eAAO,MAAM,iBAAiB,UAS7B,CAAC;AAEF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,QAAQ,EACJ;QACE,MAAM,EAAE,QAAQ,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,GACD;QAAE,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AA+BD;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAGnC,QAAQ,CAAC,IAAI,EAAE,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFzC,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,yBAAyB,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAK5C;AA8DD,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qEAAqE;AACrE,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAE,GAC/D;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,KAAK,CAAC;QACb,0BAA0B;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,6BAA6B;QAC7B,MAAM,EAAE,MAAM,CAAC;QACf,iFAAiF;QACjF,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC,CAAC;IACH,wDAAwD;IACxD,MAAM,EAAE,OAAO,CAAC;CACjB,GACD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA4ZvE;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAClC,KAAK,EACL,OAAO,EACP,MAAM,EACN,SAA+B,EAC/B,GAAG,MAAM,EACV,EAAE,cAAc,GAAG;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyGxB;AAiED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,kBAAkB,GACvB,cAAc,CA8BhB;AA8JD,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAsXpC"}
@@ -15,8 +15,20 @@ export interface GuidanceRefreshReport {
15
15
  version: string;
16
16
  /** Why a stale project was not refreshed automatically. */
17
17
  reason?: 'mode-warn' | 'ci' | 'lockfile-mismatch';
18
+ /** Units written or removed (or, when stale, that would be). */
18
19
  changed: GuidanceUnitResult[];
20
+ /**
21
+ * Units left alone: edited or not written by IWSDK, written by a newer
22
+ * release, or retired but kept (reason `retired`).
23
+ */
19
24
  skipped: GuidanceUnitResult[];
25
+ /**
26
+ * Units the installed release ships that the project does not have: the
27
+ * developer removed them (or a block or import from their file), or they
28
+ * are new in the release. The refresh adds only units that replace retired
29
+ * guidance it removes; `agents sync` adds these.
30
+ */
31
+ missing: GuidanceUnitResult[];
20
32
  migrations: MaterializedMigration[];
21
33
  notice: string;
22
34
  }
@@ -25,9 +37,17 @@ export declare function resolveAgentGuidanceMode(projectRoot: string, env?: Node
25
37
  export declare function readGuidanceVersion(projectRoot: string): string | null;
26
38
  export { readLockedCoreVersion };
27
39
  /**
28
- * Called by `iwsdk dev up`/`restart`. When the installed @iwsdk/core ships
29
- * different guidance than the project has, refresh the files nobody edited,
30
- * or report it when refreshing is not safe. Never throws.
40
+ * Called by `iwsdk dev up`/`restart`. Brings the guidance a project already
41
+ * has up to the installed @iwsdk/core: files IWSDK wrote and nobody edited are
42
+ * updated. A retired unit is replaced whole: removed, with its successors
43
+ * written in the same run when the release names them (and kept otherwise),
44
+ * so a refresh never leaves less guidance than it found. Apart from those
45
+ * successors it never adds a skill, file, AGENTS.md block, CLAUDE.md import
46
+ * or skill permission the project lacks, since the developer may have
47
+ * removed it on purpose; units new in the release are not added either. A
48
+ * refresh lists them, and `iwsdk agents sync` adds them. In CI, in warn mode,
49
+ * or when node_modules disagrees with the lockfile it only reports. Returns
50
+ * null when nothing needs refreshing; never throws.
31
51
  */
32
52
  export declare function refreshAgentGuidanceForDev(projectRoot: string, env?: NodeJS.ProcessEnv): Promise<GuidanceRefreshReport | null>;
33
53
  //# sourceMappingURL=guidance-refresh.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"guidance-refresh.d.ts","sourceRoot":"","sources":["../src/guidance-refresh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IAC1C,wEAAwE;IACxE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,mBAAmB,CAAC;IAClD,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,iBAAiB,CAMnB;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUtE;AAGD,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA0GvC"}
1
+ {"version":3,"file":"guidance-refresh.d.ts","sourceRoot":"","sources":["../src/guidance-refresh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAML,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IAC1C,wEAAwE;IACxE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,mBAAmB,CAAC;IAClD,gEAAgE;IAChE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B;;;OAGG;IACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,iBAAiB,CAMnB;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQtE;AAGD,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAgFjC;;;;;;;;;;;;GAYG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAiHvC"}
@@ -1 +1 @@
1
- {"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkHH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,EAAE,CAoFV;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB/D;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAO9C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAc9C;AAED,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAgEnE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAkC7D;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAmBjD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAmBlD;AAED,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAqBrC"}
1
+ {"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkHH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,EAAE,CAoFV;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB/D;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAO9C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAc9C;AAED,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAgEnE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAkC7D;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAmBjD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAwBlD;AAED,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAqBrC"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAoB,KAAK,EAAiB,MAAM,gBAAgB,CAAC;AAuC7E,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,CAAC;AAE5D,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoN5E"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAoB,KAAK,EAAiB,MAAM,gBAAgB,CAAC;AAuC7E,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,CAAC;AAE5D,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAsN5E"}