@open-agent-toolkit/cli 0.2.26 → 0.2.28
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/NOTICES.md +156 -0
- package/assets/agents/oat-phase-implementer.md +312 -7
- package/assets/docs/contributing/explainer-kit-verification.md +125 -0
- package/assets/docs/contributing/index.md +1 -0
- package/assets/docs/reference/troubleshooting.md +47 -0
- package/assets/docs/workflows/projects/artifacts.md +24 -6
- package/assets/docs/workflows/projects/implementation-execution.md +151 -1
- package/assets/docs/workflows/skills/explainer-kit-providers.md +144 -0
- package/assets/docs/workflows/skills/explainer-kit.md +121 -69
- package/assets/docs/workflows/skills/index.md +1 -0
- package/assets/public-package-versions.json +4 -4
- package/assets/skills/explainer-kit/SKILL.md +18 -3
- package/assets/skills/explainer-kit/recipes/project-recap.json +43 -16
- package/assets/skills/explainer-kit/references/contracts.md +167 -20
- package/assets/skills/explainer-kit/references/golden-conformance.md +80 -0
- package/assets/skills/explainer-kit/references/visual-authoring.md +92 -0
- package/assets/skills/explainer-kit/references/visual-review.md +57 -0
- package/assets/skills/explainer-kit/schemas/author-request.v2.schema.json +172 -1
- package/assets/skills/explainer-kit/schemas/build-record.schema.json +7 -1
- package/assets/skills/explainer-kit/schemas/fact-base.schema.json +38 -2
- package/assets/skills/explainer-kit/schemas/manifest.schema.json +25 -1
- package/assets/skills/explainer-kit/schemas/run-request.schema.json +4 -0
- package/assets/skills/explainer-kit/schemas/set-plan.v1.schema.json +149 -0
- package/assets/skills/explainer-kit/schemas/visual-review-request.v1.schema.json +117 -0
- package/assets/skills/explainer-kit/schemas/visual-review-result.v1.schema.json +80 -0
- package/assets/skills/explainer-kit/scripts/lib/browser-runtime.mjs +148 -4
- package/assets/skills/explainer-kit/scripts/lib/catalog.mjs +243 -0
- package/assets/skills/explainer-kit/scripts/lib/contracts.mjs +586 -8
- package/assets/skills/explainer-kit/scripts/lib/diagram.mjs +285 -8
- package/assets/skills/explainer-kit/scripts/lib/durability.mjs +35 -0
- package/assets/skills/explainer-kit/scripts/lib/fact-base.mjs +144 -8
- package/assets/skills/explainer-kit/scripts/lib/package-coverage.mjs +379 -0
- package/assets/skills/explainer-kit/scripts/lib/png.mjs +287 -0
- package/assets/skills/explainer-kit/scripts/lib/qa.mjs +280 -8
- package/assets/skills/explainer-kit/scripts/lib/recipes.mjs +132 -3
- package/assets/skills/explainer-kit/scripts/lib/records.mjs +513 -21
- package/assets/skills/explainer-kit/scripts/lib/render.mjs +67 -3
- package/assets/skills/explainer-kit/scripts/lib/s3-static.mjs +43 -1
- package/assets/skills/explainer-kit/scripts/lib/set-plan.mjs +208 -0
- package/assets/skills/explainer-kit/scripts/lib/source-backlinks.mjs +218 -0
- package/assets/skills/explainer-kit/scripts/lib/visual-review.mjs +380 -0
- package/assets/skills/explainer-kit/scripts/render-qa.mjs +48 -10
- package/assets/skills/explainer-kit/scripts/run.mjs +859 -134
- package/assets/skills/oat-dispatch-subagents/SKILL.md +16 -3
- package/assets/skills/oat-explainer-kit/SKILL.md +40 -12
- package/assets/skills/oat-explainer-kit/references/author-callback.md +12 -10
- package/assets/skills/oat-explainer-kit/references/lifecycle-contract.md +40 -2
- package/assets/skills/oat-explainer-kit/references/visual-review-callback.md +72 -0
- package/assets/skills/oat-explainer-kit/scripts/bind-project-sources.mjs +167 -5
- package/assets/skills/oat-explainer-kit/scripts/finalize-tracked-run.mjs +92 -5
- package/assets/skills/oat-explainer-kit/scripts/run.mjs +324 -2
- package/assets/skills/oat-project-autonomous/references/gate-inventory.md +2 -2
- package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +2 -2
- package/assets/skills/oat-project-implement/SKILL.md +5 -4
- package/assets/skills/oat-project-implement/references/dispatch-and-dry-run.md +21 -0
- package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +2 -2
- package/assets/skills/oat-project-implement/references/phase-execution.md +359 -12
- package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +2 -2
- package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +2 -2
- package/assets/templates/state.md +7 -0
- package/dist/commands/project/archive/archive-utils.d.ts +1 -0
- package/dist/commands/project/archive/archive-utils.d.ts.map +1 -1
- package/dist/commands/project/archive/archive-utils.js +109 -42
- package/dist/commands/project/archive/explainer-package-coverage.d.ts +14 -0
- package/dist/commands/project/archive/explainer-package-coverage.d.ts.map +1 -0
- package/dist/commands/project/archive/explainer-package-coverage.js +27 -0
- package/dist/commands/project/archive/explainer-source-backlinks.d.ts +18 -0
- package/dist/commands/project/archive/explainer-source-backlinks.d.ts.map +1 -0
- package/dist/commands/project/archive/explainer-source-backlinks.js +27 -0
- package/dist/commands/project/archive/push-runner.d.ts +2 -1
- package/dist/commands/project/archive/push-runner.d.ts.map +1 -1
- package/dist/commands/project/archive/push-runner.js +5 -1
- package/dist/release/public-package-contract.d.ts +6 -0
- package/dist/release/public-package-contract.d.ts.map +1 -1
- package/dist/release/public-package-contract.js +75 -0
- package/package.json +2 -2
|
@@ -235,9 +235,9 @@ remains immutable baseline evidence for the original p01-t01 verification.
|
|
|
235
235
|
| `oat-project-import-plan/SKILL.md` | `f7ca8635452f -> NG`; `c2e5fa410069 -> NG`; `655d61df0a8f -> NG`; `dceff5cc04b5 -> NG`; `1af4957a1af2 -> IMPORT-01`; `45b699c1c0b5 -> IMPORT-01`; `ba6d120791c1 -> IMPORT-01`; `070ebc5259af -> IMPORT-03`; `c11552696e2e -> IMPORT-03`; `cfe661966baf -> IMPORT-04`; `baa91c0a0bf8 -> NG`; `e364e84b2702 -> NG`; `39031985a945 -> IMPORT-06`; `f106aa29a217 -> IMPORT-07`; `65038450aee3 -> IMPORT-07`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPORT-09` |
|
|
236
236
|
| `oat-project-implement/SKILL.md` | `18980f6bc1a6 -> NG`; `e0355c7a05e9 -> IMPLEMENT-11+IMPLEMENT-13+IMPLEMENT-16`; `6296f41ae11c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> IMPLEMENT-01`; `8ce8a09feca4 -> NG`; `bd0cb4988188 -> NG`; `28af4ee0055d -> NG` |
|
|
237
237
|
| `oat-project-implement/references/completion-and-closeout.md` | `f7dab9c1f96c -> IMPLEMENT-12`; `c69c17a069a8 -> IMPLEMENT-14`; `a97fa5634a68 -> IMPLEMENT-14`; `3af58881811c -> IMPLEMENT-14`; `4203e1f49d0f -> IMPLEMENT-14`; `c3bd2458a3d3 -> IMPLEMENT-13`; `95b5eafc070d -> IMPLEMENT-13`; `25ecbe9c998b -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f6f24fd71da4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f18283bc1cf9 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `2c1ffc4a82dd -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `3454a07aa843 -> IMPLEMENT-16`; `0d86e2098cfb -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d5fe597d266f -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `55a152e944c1 -> IMPLEMENT-16`; `effac7cbd573 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d2a34d8b148 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d27462aaed26 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d52ecb17268 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `5b91aabe3757 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `fd0ad919f702 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `63bf28df1474 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a4ed471dbc78 -> IMPLEMENT-16`; `6b7a64cec6e5 -> IMPLEMENT-16`; `0a4fdba0ebc0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a5033c2aada5 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `e77609eddba0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `351156e8dde4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `51d45bd2bbd1 -> IMPLEMENT-16`; `f7796ffcc804 -> IMPLEMENT-16`; `990d730cb494 -> IMPLEMENT-16`; `6ed28bb7d384 -> IMPLEMENT-16`; `8b7d4b5bcf1b -> IMPLEMENT-16`; `88aad500e6e9 -> IMPLEMENT-16`; `877e3e3f9eda -> IMPLEMENT-16`; `fc03c97f834e -> IMPLEMENT-16`; `12939a3da5e0 -> IMPLEMENT-16`; `bdb418335a88 -> IMPLEMENT-16`; `fba97e596ebd -> IMPLEMENT-16`; `3d0b5e2f14f0 -> IMPLEMENT-17`; `87f1424a8692 -> NG`; `6b1ec05182f0 -> IMPLEMENT-11`; `e6d696a27c91 -> NG`; `c77f8ccb52ad -> NG`; `48de2614c0ba -> IMPLEMENT-11`; `32d53f5212e5 -> IMPLEMENT-11`; `7cdb4a9c57b7 -> IMPLEMENT-11`; `16ffc0aa099b -> IMPLEMENT-11`; `d6868ea10b3f -> IMPLEMENT-11`; `4f05ff5567be -> IMPLEMENT-11`; `c70b47ae7a6d -> IMPLEMENT-11`; `5fafd093b58e -> NG`; `567d43ab0c2e -> NG`; `21ceaf7e658a -> NG`; `249427a9f475 -> NG`; `8a7ec13a9b7c -> NG`; `9aeb7fce2012 -> IMPLEMENT-18`; `f11a7cdda220 -> IMPLEMENT-18`; `4523ac029152 -> NG`; `6e87b08c4046 -> NG`; `baa6052c7f0a -> IMPLEMENT-18`; `27d3fad116b1 -> IMPLEMENT-18`; `2cfbeb4388a5 -> IMPLEMENT-18`; `c56ea56a56db -> NG`; `43e2e3c1380d -> IMPLEMENT-17`; `b49690277fb5 -> NG`; `df12304d6a36 -> NG`; `52eacac11fef -> IMPLEMENT-17`; `60092df6b17b -> IMPLEMENT-17`; `361872c6b00e -> IMPLEMENT-17`; `d2bc711a75fb -> IMPLEMENT-17` |
|
|
238
|
-
| `oat-project-implement/references/dispatch-and-dry-run.md` | `21b85f5e4daa -> IMPLEMENT-08`; `74c92b32bb2a -> IMPLEMENT-08`; `8efd2d0517ab -> IMPLEMENT-09`; `461ed9b3e495 -> IMPLEMENT-09`; `b5ad64fd744d -> NG`; `14ce436cfffa -> NG`; `043ca36da3e2 -> NG`; `a23e45c1dc8d -> NG`; `498143bb41a7 -> NG`; `4fe3eb179023 -> NG`; `7f75485e5a33 -> NG`; `8ec3a96df029 -> NG`; `16c3f96e758d -> NG`; `5915c41fe058 -> NG`; `f51e43eeac56 -> NG`; `fd41c25623cb -> NG`; `58a932ed6453 -> NG`; `4718bd3ce12d -> NG`; `58c444a2126b -> NG`; `2df3adae4120 -> NG`; `e75df892b55c -> NG`; `8ba5dbd2a0d8 -> NG`
|
|
238
|
+
| `oat-project-implement/references/dispatch-and-dry-run.md` | `21b85f5e4daa -> IMPLEMENT-08`; `74c92b32bb2a -> IMPLEMENT-08`; `8efd2d0517ab -> IMPLEMENT-09`; `461ed9b3e495 -> IMPLEMENT-09`; `b5ad64fd744d -> NG`; `14ce436cfffa -> NG`; `043ca36da3e2 -> NG`; `a23e45c1dc8d -> NG`; `498143bb41a7 -> NG`; `4fe3eb179023 -> NG`; `7f75485e5a33 -> NG`; `8ec3a96df029 -> NG`; `16c3f96e758d -> NG`; `5915c41fe058 -> NG`; `f51e43eeac56 -> NG`; `fd41c25623cb -> NG`; `58a932ed6453 -> NG`; `4718bd3ce12d -> NG`; `58c444a2126b -> NG`; `2df3adae4120 -> NG`; `e75df892b55c -> NG`; `8ba5dbd2a0d8 -> NG`; `4d6c519131e5 -> NG` |
|
|
239
239
|
| `oat-project-implement/references/docs/autonomy-contract.md` | `* -> NG` |
|
|
240
|
-
| `oat-project-implement/references/phase-execution.md` | `27737e814790 -> NG`; `6dda2b8e62e2 -> IMPLEMENT-10`; `b3197086bb1e -> IMPLEMENT-10`
|
|
240
|
+
| `oat-project-implement/references/phase-execution.md` | `27737e814790 -> NG`; `6dda2b8e62e2 -> IMPLEMENT-10`; `b3197086bb1e -> IMPLEMENT-10`; `25f2a6e104ee -> NG`; `4aa21120295f -> NG` |
|
|
241
241
|
| `oat-project-implement/references/plan-and-resume.md` | `413829d31e32 -> IMPLEMENT-02`; `c7706cd8ad09 -> IMPLEMENT-03`; `a80a948df658 -> IMPLEMENT-03`; `b7ea139780ec -> IMPLEMENT-03+IMPLEMENT-04`; `8d438f2180ba -> IMPLEMENT-03`; `9e72e0518cda -> IMPLEMENT-03`; `3e177a1021e6 -> IMPLEMENT-03+IMPLEMENT-04`; `b59fc9eb9ce3 -> IMPLEMENT-03`; `a2b1d6855283 -> IMPLEMENT-03`; `44351a32e52a -> IMPLEMENT-03`; `b98b022f5523 -> IMPLEMENT-03`; `e9f5b949e214 -> IMPLEMENT-03`; `316fb6d9e980 -> IMPLEMENT-03`; `8b25a2c5c548 -> IMPLEMENT-03`; `1a59b1c0e705 -> IMPLEMENT-03`; `466cd562fc52 -> IMPLEMENT-03`; `083d896978d5 -> IMPLEMENT-03`; `f4ab11c13ae9 -> IMPLEMENT-03`; `7dc17ffcc1c4 -> IMPLEMENT-03`; `f731a90adabd -> IMPLEMENT-04`; `886ac01e7aa9 -> IMPLEMENT-04`; `b715db67df0c -> IMPLEMENT-04`; `2d9f26a539f3 -> IMPLEMENT-10`; `28384dee114f -> IMPLEMENT-05`; `f2591a4978b4 -> NG`; `8290823080b5 -> IMPLEMENT-06`; `f75789bf6c8e -> IMPLEMENT-07` |
|
|
242
242
|
| `oat-project-document/SKILL.md` | `4fc2d8618208 -> NG`; `3f9b0273ba77 -> NG`; `40f8be47affa -> NG`; `3a3c390528f3 -> DOCUMENT-03`; `2a7ba093b315 -> DOCUMENT-02`; `252aabe44db2 -> DOCUMENT-02`; `3751172de299 -> DOCUMENT-02`; `b987a0697ba9 -> DOCUMENT-01`; `a06ff3ca7926 -> NG`; `0d04714ca9fc -> NG`; `f79af01d94c6 -> DOCUMENT-02`; `71634113c348 -> DOCUMENT-02`; `cdb707f5081e -> NG` |
|
|
243
243
|
| `oat-project-document/references/docs/autonomy-contract.md` | `* -> NG` |
|
|
@@ -14,6 +14,13 @@ oat_parallel_execution: false
|
|
|
14
14
|
oat_phase: { OAT_PHASE } # Current phase: discovery | spec | design | plan | implement | decomposition
|
|
15
15
|
oat_phase_status: in_progress # Status: in_progress | complete | pr_open
|
|
16
16
|
# oat_orchestration_retry_limit: 2 # optional; override fix-loop retry limit (range 0-5)
|
|
17
|
+
# oat_phase_recovery_policy: # optional; automatic append-only post-commit phase recovery
|
|
18
|
+
# default_attempt_limit: 10 # project default, integer 0-20; 0 disables automatic recovery
|
|
19
|
+
# phase_attempt_limits: {} # optional pNN: 0-20 overrides; prior usage never resets
|
|
20
|
+
# phase_attempt_usage: # authoritative monotonic per-phase attempt ledger
|
|
21
|
+
# pNN:
|
|
22
|
+
# used_attempts: 0
|
|
23
|
+
# pending_attempt: null # null or {attempt, event_id, original_request_id, original_task_id, original_commit, discovered_by, dispatch_target, reservation_head, status}
|
|
17
24
|
# oat_dispatch_policy: # optional project dispatch policy; managed keeps OAT selection active, inherit leaves controls to the host
|
|
18
25
|
# mode: managed # managed | inherit
|
|
19
26
|
# policy: balanced # economy | balanced | high | frontier | uncapped; omit when mode: inherit
|
|
@@ -151,6 +151,7 @@ export declare function resolveLocalArchiveProjectPath(projectsRoot: string, pro
|
|
|
151
151
|
export declare function resolvePrimaryRepoRoot(repoRoot: string, dependencies?: ResolvePrimaryRepoRootDependencies): Promise<string>;
|
|
152
152
|
export declare function resolveArchiveProjectTarget(options: ResolveArchiveProjectTargetOptions, dependencies?: ResolveArchiveProjectTargetDependencies): Promise<ArchiveProjectTarget>;
|
|
153
153
|
export declare function assertDurableArchiveProjectTarget(target: ArchiveProjectTarget): void;
|
|
154
|
+
export declare function verifySelectedProjectRecapForArchive(projectPath: string, projectRecapRun: string): Promise<void>;
|
|
154
155
|
export declare function archiveProjectOnCompletion(options: ArchiveProjectOnCompletionOptions, dependencies?: ArchiveProjectOnCompletionDependencies): Promise<ArchiveProjectOnCompletionResult>;
|
|
155
156
|
export declare function ensureS3ArchiveAccess(options: EnsureS3ArchiveAccessOptions, dependencies?: EnsureS3ArchiveAccessDependencies): Promise<EnsureS3ArchiveAccessResult>;
|
|
156
157
|
export {};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/archive-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,MAAM,EAGP,MAAM,kBAAkB,CAAC;AAc1B,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EACT,SAAS,EACT,UAAU,EACX,MAAM,QAAQ,CAAC;
|
|
1
|
+
{"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/archive-utils.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,6 +5,8 @@ import { basename, dirname, isAbsolute, join, posix as path, relative, resolve,
|
|
|
5
5
|
import { promisify } from 'node:util';
|
|
6
6
|
import { CliError } from '../../../errors/cli-error.js';
|
|
7
7
|
import { copyDirectory, copySingleFile, dirExists, ensureDir, fileExists, } from '../../../fs/io.js';
|
|
8
|
+
import { loadExplainerPackageCoverage } from './explainer-package-coverage.js';
|
|
9
|
+
import { loadExplainerSourceBacklinks, } from './explainer-source-backlinks.js';
|
|
8
10
|
const execFileAsync = promisify(execFileCallback);
|
|
9
11
|
export const ARCHIVE_SNAPSHOT_METADATA_FILENAME = '.oat-archive-source.json';
|
|
10
12
|
/**
|
|
@@ -281,7 +283,7 @@ async function exportProjectSummary(archivePath, snapshotName, summaryExportPath
|
|
|
281
283
|
await copySummary(summarySource, summaryTarget);
|
|
282
284
|
return summaryTarget;
|
|
283
285
|
}
|
|
284
|
-
function parseProjectRecapManifest(contents) {
|
|
286
|
+
async function parseProjectRecapManifest(contents) {
|
|
285
287
|
let value;
|
|
286
288
|
try {
|
|
287
289
|
value = JSON.parse(contents);
|
|
@@ -289,43 +291,13 @@ function parseProjectRecapManifest(contents) {
|
|
|
289
291
|
catch {
|
|
290
292
|
throw new CliError('Selected project recap has an invalid manifest.json.');
|
|
291
293
|
}
|
|
292
|
-
|
|
294
|
+
const sourceBacklinks = await loadExplainerSourceBacklinks();
|
|
295
|
+
if (!isProjectRecapManifestV1(value, sourceBacklinks)) {
|
|
293
296
|
throw new CliError('Selected project recap manifest does not match the explainer-kit manifest contract.');
|
|
294
297
|
}
|
|
295
|
-
const requiredProvenancePaths = [
|
|
296
|
-
'run-request.json',
|
|
297
|
-
'source/content-approval.json',
|
|
298
|
-
];
|
|
299
|
-
const recordedImmutablePaths = Object.keys(value.immutableHashes);
|
|
300
|
-
const missingLegacyPaths = requiredProvenancePaths.filter((relativePath) => !(relativePath in value.immutableHashes));
|
|
301
|
-
if (missingLegacyPaths.length > 0) {
|
|
302
|
-
throw new CliError(`Selected project recap uses a legacy manifest missing immutable coverage for ${missingLegacyPaths.join(', ')}; regenerate the recap package before archival.`);
|
|
303
|
-
}
|
|
304
|
-
const expectedImmutablePaths = new Set([
|
|
305
|
-
...requiredProvenancePaths,
|
|
306
|
-
value.source.factBasePath,
|
|
307
|
-
'source/fact-base.md',
|
|
308
|
-
...(value.source.authorResultPaths ?? []),
|
|
309
|
-
value.theme.path,
|
|
310
|
-
...value.artifacts.flatMap((artifact) => [
|
|
311
|
-
artifact.contentPath,
|
|
312
|
-
...(artifact.status === 'built' &&
|
|
313
|
-
typeof artifact.renderedPath === 'string'
|
|
314
|
-
? [artifact.renderedPath]
|
|
315
|
-
: []),
|
|
316
|
-
]),
|
|
317
|
-
]);
|
|
318
|
-
if (expectedImmutablePaths.size === 0 ||
|
|
319
|
-
expectedImmutablePaths.size !== recordedImmutablePaths.length ||
|
|
320
|
-
[...expectedImmutablePaths].some((relativePath) => !(relativePath in value.immutableHashes)) ||
|
|
321
|
-
value.artifacts.some((artifact) => artifact.status === 'built' &&
|
|
322
|
-
typeof artifact.renderedPath === 'string' &&
|
|
323
|
-
artifact.hash !== value.immutableHashes[artifact.renderedPath])) {
|
|
324
|
-
throw new CliError('Selected project recap manifest immutable hashes do not cover the complete v1 package.');
|
|
325
|
-
}
|
|
326
298
|
return value;
|
|
327
299
|
}
|
|
328
|
-
function isProjectRecapManifestV1(value) {
|
|
300
|
+
function isProjectRecapManifestV1(value, sourceBacklinks) {
|
|
329
301
|
if (!isRecord(value) ||
|
|
330
302
|
!hasExactKeys(value, [
|
|
331
303
|
'schemaVersion',
|
|
@@ -351,12 +323,14 @@ function isProjectRecapManifestV1(value) {
|
|
|
351
323
|
!isNonEmptyString(value.recipe.id) ||
|
|
352
324
|
!isNonEmptyString(value.recipe.version) ||
|
|
353
325
|
!isRecord(value.source) ||
|
|
354
|
-
!hasExactKeys(value.source, ['factBasePath', 'factBaseHash', 'inputHashes'], ['sourceRevision', 'authorResultPaths']) ||
|
|
326
|
+
!hasExactKeys(value.source, ['factBasePath', 'factBaseHash', 'inputHashes'], ['sourceRevision', 'authorResultPaths', 'backlinks']) ||
|
|
355
327
|
!isSafeRelativePath(value.source.factBasePath) ||
|
|
356
328
|
!isSha256(value.source.factBaseHash) ||
|
|
357
329
|
!isHashMap(value.source.inputHashes) ||
|
|
358
330
|
(value.source.authorResultPaths !== undefined &&
|
|
359
331
|
!isUniqueSafePathArray(value.source.authorResultPaths)) ||
|
|
332
|
+
(value.source.backlinks !== undefined &&
|
|
333
|
+
!isCanonicalSourceBacklinks(value.source.backlinks, sourceBacklinks)) ||
|
|
360
334
|
(value.source.sourceRevision !== undefined &&
|
|
361
335
|
!isNonEmptyString(value.source.sourceRevision)) ||
|
|
362
336
|
!isRecord(value.theme) ||
|
|
@@ -369,7 +343,13 @@ function isProjectRecapManifestV1(value) {
|
|
|
369
343
|
new Set(value.artifacts.map((artifact) => JSON.stringify(artifact)))
|
|
370
344
|
.size !== value.artifacts.length ||
|
|
371
345
|
!isHashMap(value.immutableHashes) ||
|
|
372
|
-
![
|
|
346
|
+
![
|
|
347
|
+
'built-durable',
|
|
348
|
+
'built-not-durable',
|
|
349
|
+
'built-needs-review',
|
|
350
|
+
'failed',
|
|
351
|
+
'incomplete',
|
|
352
|
+
].includes(String(value.outcome)) ||
|
|
373
353
|
!isPathHashRecord(value.buildRecord, 'build-record.json') ||
|
|
374
354
|
(value.publishReceipt !== undefined &&
|
|
375
355
|
!isPathHashRecord(value.publishReceipt, 'publish-receipt.json')) ||
|
|
@@ -451,6 +431,32 @@ function isHashMap(value) {
|
|
|
451
431
|
return (isRecord(value) &&
|
|
452
432
|
Object.entries(value).every(([relativePath, hash]) => isSafeRelativePath(relativePath) && isSha256(hash)));
|
|
453
433
|
}
|
|
434
|
+
function isCanonicalSourceBacklinks(value, sourceBacklinks) {
|
|
435
|
+
if (!Array.isArray(value)) {
|
|
436
|
+
return false;
|
|
437
|
+
}
|
|
438
|
+
const identities = new Set();
|
|
439
|
+
for (const backlink of value) {
|
|
440
|
+
if (!isRecord(backlink) ||
|
|
441
|
+
!hasExactKeys(backlink, ['sourceId', 'url']) ||
|
|
442
|
+
!isNonEmptyString(backlink.sourceId) ||
|
|
443
|
+
typeof backlink.url !== 'string') {
|
|
444
|
+
return false;
|
|
445
|
+
}
|
|
446
|
+
try {
|
|
447
|
+
sourceBacklinks.parseCanonicalGithubBlobUrl(backlink.url);
|
|
448
|
+
}
|
|
449
|
+
catch {
|
|
450
|
+
return false;
|
|
451
|
+
}
|
|
452
|
+
const identity = `${backlink.sourceId}\0${backlink.url}`;
|
|
453
|
+
if (identities.has(identity)) {
|
|
454
|
+
return false;
|
|
455
|
+
}
|
|
456
|
+
identities.add(identity);
|
|
457
|
+
}
|
|
458
|
+
return true;
|
|
459
|
+
}
|
|
454
460
|
function isUniqueSafePathArray(value) {
|
|
455
461
|
return (Array.isArray(value) &&
|
|
456
462
|
value.length > 0 &&
|
|
@@ -544,17 +550,78 @@ async function verifyProjectRecapImmutableHashes(stagedRoot, manifest) {
|
|
|
544
550
|
}
|
|
545
551
|
return entries.length;
|
|
546
552
|
}
|
|
553
|
+
async function readVerifiedRunMode(runRoot) {
|
|
554
|
+
let request;
|
|
555
|
+
try {
|
|
556
|
+
request = JSON.parse(await readFile(join(runRoot, 'run-request.json'), 'utf8'));
|
|
557
|
+
}
|
|
558
|
+
catch {
|
|
559
|
+
throw new CliError('Hash-verified project recap run-request.json must contain valid JSON.');
|
|
560
|
+
}
|
|
561
|
+
if (!isRecord(request) ||
|
|
562
|
+
(request.mode !== 'interactive' && request.mode !== 'unattended')) {
|
|
563
|
+
throw new CliError('Hash-verified project recap run-request.json must declare interactive or unattended mode.');
|
|
564
|
+
}
|
|
565
|
+
return request.mode;
|
|
566
|
+
}
|
|
567
|
+
async function loadVerifiedProjectRecap(projectPath, projectRecapRun) {
|
|
568
|
+
const sourceRunRoot = await resolveSelectedProjectRecapRun(projectPath, projectRecapRun);
|
|
569
|
+
const manifestContents = await readFile(join(sourceRunRoot, 'manifest.json'), 'utf8');
|
|
570
|
+
const manifest = await parseProjectRecapManifest(manifestContents);
|
|
571
|
+
if (manifest.recipe.id !== 'project-recap') {
|
|
572
|
+
throw new CliError('Selected project recap manifest recipe must be exactly `project-recap`.');
|
|
573
|
+
}
|
|
574
|
+
if (manifest.outcome === 'built-needs-review') {
|
|
575
|
+
throw new CliError('Selected project recap is built-needs-review and requires a passing visual review before archival.');
|
|
576
|
+
}
|
|
577
|
+
const verifiedArtifactCount = await verifyProjectRecapImmutableHashes(sourceRunRoot, manifest);
|
|
578
|
+
const runMode = await readVerifiedRunMode(sourceRunRoot);
|
|
579
|
+
const packageCoverage = await loadExplainerPackageCoverage();
|
|
580
|
+
const missingCoverage = packageCoverage
|
|
581
|
+
.requiredImmutablePackagePaths(manifest, { runMode })
|
|
582
|
+
.filter((relativePath) => !(relativePath in manifest.immutableHashes));
|
|
583
|
+
const missingLegacyCoverage = missingCoverage.filter((relativePath) => ['run-request.json', 'source/content-approval.json'].includes(relativePath));
|
|
584
|
+
if (missingLegacyCoverage.length > 0) {
|
|
585
|
+
throw new CliError(`Selected project recap uses a legacy manifest missing immutable coverage for ${missingLegacyCoverage.join(', ')}; regenerate the recap package before archival.`);
|
|
586
|
+
}
|
|
587
|
+
if (missingCoverage.some((relativePath) => relativePath.startsWith('qa/browser/') ||
|
|
588
|
+
relativePath.startsWith('qa/visual-review/'))) {
|
|
589
|
+
throw new CliError('Selected project recap manifest has an incomplete visual-review evidence chain.');
|
|
590
|
+
}
|
|
591
|
+
if (missingCoverage.length > 0) {
|
|
592
|
+
throw new CliError(`Selected project recap manifest immutable hashes do not cover the complete v2 package: ${missingCoverage.join(', ')}.`);
|
|
593
|
+
}
|
|
594
|
+
try {
|
|
595
|
+
await packageCoverage.validateImmutablePackageEvidence(manifest, {
|
|
596
|
+
runMode,
|
|
597
|
+
read: (relativePath) => readFile(join(sourceRunRoot, relativePath)),
|
|
598
|
+
});
|
|
599
|
+
}
|
|
600
|
+
catch (error) {
|
|
601
|
+
throw new CliError(`Selected project recap browser evidence contract is invalid: ${error instanceof Error ? error.message : String(error)}`);
|
|
602
|
+
}
|
|
603
|
+
if (manifest.artifacts.some((artifact) => artifact.status === 'built' &&
|
|
604
|
+
typeof artifact.renderedPath === 'string' &&
|
|
605
|
+
artifact.hash !== manifest.immutableHashes[artifact.renderedPath])) {
|
|
606
|
+
throw new CliError('Selected project recap artifact hashes do not match the immutable package.');
|
|
607
|
+
}
|
|
608
|
+
return {
|
|
609
|
+
sourceRunRoot,
|
|
610
|
+
manifestContents,
|
|
611
|
+
manifest,
|
|
612
|
+
verifiedArtifactCount,
|
|
613
|
+
};
|
|
614
|
+
}
|
|
615
|
+
export async function verifySelectedProjectRecapForArchive(projectPath, projectRecapRun) {
|
|
616
|
+
await loadVerifiedProjectRecap(projectPath, projectRecapRun);
|
|
617
|
+
}
|
|
547
618
|
async function exportSelectedProjectRecap(options, snapshotName, dependencies) {
|
|
548
619
|
const selectedRun = options.projectRecapRun?.trim();
|
|
549
620
|
if (!selectedRun) {
|
|
550
621
|
return null;
|
|
551
622
|
}
|
|
552
|
-
const
|
|
553
|
-
const
|
|
554
|
-
const sourceManifest = parseProjectRecapManifest(sourceManifestContents);
|
|
555
|
-
if (sourceManifest.recipe.id !== 'project-recap') {
|
|
556
|
-
throw new CliError('Selected project recap manifest recipe must be exactly `project-recap`.');
|
|
557
|
-
}
|
|
623
|
+
const verified = await loadVerifiedProjectRecap(options.projectPath, selectedRun);
|
|
624
|
+
const { sourceRunRoot, manifestContents: sourceManifestContents, manifest: sourceManifest, } = verified;
|
|
558
625
|
const exportRoot = join(options.repoRoot, '.oat', 'repo', 'reference', 'project-recaps', snapshotName);
|
|
559
626
|
if (await pathExists(exportRoot)) {
|
|
560
627
|
throw new CliError(`Project recap export destination \`${exportRoot}\` already exists; refusing to overwrite it.`);
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
declare const PACKAGE_COVERAGE_VERSION = "explainer-kit.package-coverage/v2";
|
|
2
|
+
export interface ExplainerPackageCoverage {
|
|
3
|
+
PACKAGE_COVERAGE_VERSION: typeof PACKAGE_COVERAGE_VERSION;
|
|
4
|
+
requiredImmutablePackagePaths: (manifest: unknown, options?: {
|
|
5
|
+
runMode?: 'interactive' | 'unattended';
|
|
6
|
+
}) => string[];
|
|
7
|
+
validateImmutablePackageEvidence: (manifest: unknown, options: {
|
|
8
|
+
runMode?: 'interactive' | 'unattended';
|
|
9
|
+
read: (path: string) => Promise<Buffer | string>;
|
|
10
|
+
}) => Promise<void>;
|
|
11
|
+
}
|
|
12
|
+
export declare function loadExplainerPackageCoverage(): Promise<ExplainerPackageCoverage>;
|
|
13
|
+
export {};
|
|
14
|
+
//# sourceMappingURL=explainer-package-coverage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"explainer-package-coverage.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/explainer-package-coverage.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,wBAAwB,sCAAsC,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,wBAAwB,EAAE,OAAO,wBAAwB,CAAC;IAC1D,6BAA6B,EAAE,CAC7B,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAAA;KAAE,KACjD,MAAM,EAAE,CAAC;IACd,gCAAgC,EAAE,CAChC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE;QACP,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;QACvC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;KAClD,KACE,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAID,wBAAgB,4BAA4B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAGhF"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { join } from 'node:path';
|
|
2
|
+
import { pathToFileURL } from 'node:url';
|
|
3
|
+
import { CliError } from '../../../errors/cli-error.js';
|
|
4
|
+
import { resolveAssetsRoot } from '../../../fs/assets.js';
|
|
5
|
+
const PACKAGE_COVERAGE_VERSION = 'explainer-kit.package-coverage/v2';
|
|
6
|
+
let cachedCoverage;
|
|
7
|
+
export function loadExplainerPackageCoverage() {
|
|
8
|
+
cachedCoverage ??= loadGeneratedCoverage();
|
|
9
|
+
return cachedCoverage;
|
|
10
|
+
}
|
|
11
|
+
async function loadGeneratedCoverage() {
|
|
12
|
+
const assetsRoot = await resolveAssetsRoot();
|
|
13
|
+
const modulePath = join(assetsRoot, 'skills', 'explainer-kit', 'scripts', 'lib', 'package-coverage.mjs');
|
|
14
|
+
let loaded;
|
|
15
|
+
try {
|
|
16
|
+
loaded = (await import(pathToFileURL(modulePath).href));
|
|
17
|
+
}
|
|
18
|
+
catch (error) {
|
|
19
|
+
throw new CliError(`Bundled explainer package coverage could not be loaded: ${error instanceof Error ? error.message : String(error)}`, 2);
|
|
20
|
+
}
|
|
21
|
+
if (loaded.PACKAGE_COVERAGE_VERSION !== PACKAGE_COVERAGE_VERSION ||
|
|
22
|
+
typeof loaded.requiredImmutablePackagePaths !== 'function' ||
|
|
23
|
+
typeof loaded.validateImmutablePackageEvidence !== 'function') {
|
|
24
|
+
throw new CliError(`Bundled assets must provide ${PACKAGE_COVERAGE_VERSION} package coverage.`, 2);
|
|
25
|
+
}
|
|
26
|
+
return loaded;
|
|
27
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
declare const SOURCE_BACKLINK_CONTRACT_VERSION = "explainer-kit.source-backlinks/v1";
|
|
2
|
+
export interface CanonicalSourceBacklink {
|
|
3
|
+
repository: string;
|
|
4
|
+
revision: string;
|
|
5
|
+
path: string;
|
|
6
|
+
lineRange: {
|
|
7
|
+
start: number;
|
|
8
|
+
end: number;
|
|
9
|
+
};
|
|
10
|
+
url: string;
|
|
11
|
+
}
|
|
12
|
+
export interface ExplainerSourceBacklinks {
|
|
13
|
+
SOURCE_BACKLINK_CONTRACT_VERSION: typeof SOURCE_BACKLINK_CONTRACT_VERSION;
|
|
14
|
+
parseCanonicalGithubBlobUrl: (value: string) => CanonicalSourceBacklink;
|
|
15
|
+
}
|
|
16
|
+
export declare function loadExplainerSourceBacklinks(): Promise<ExplainerSourceBacklinks>;
|
|
17
|
+
export {};
|
|
18
|
+
//# sourceMappingURL=explainer-source-backlinks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"explainer-source-backlinks.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/explainer-source-backlinks.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,gCAAgC,sCAAsC,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB;IACvC,gCAAgC,EAAE,OAAO,gCAAgC,CAAC;IAC1E,2BAA2B,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,uBAAuB,CAAC;CACzE;AAID,wBAAgB,4BAA4B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAGhF"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { join } from 'node:path';
|
|
2
|
+
import { pathToFileURL } from 'node:url';
|
|
3
|
+
import { CliError } from '../../../errors/cli-error.js';
|
|
4
|
+
import { resolveAssetsRoot } from '../../../fs/assets.js';
|
|
5
|
+
const SOURCE_BACKLINK_CONTRACT_VERSION = 'explainer-kit.source-backlinks/v1';
|
|
6
|
+
let cachedBacklinks;
|
|
7
|
+
export function loadExplainerSourceBacklinks() {
|
|
8
|
+
cachedBacklinks ??= loadGeneratedBacklinks();
|
|
9
|
+
return cachedBacklinks;
|
|
10
|
+
}
|
|
11
|
+
async function loadGeneratedBacklinks() {
|
|
12
|
+
const assetsRoot = await resolveAssetsRoot();
|
|
13
|
+
const modulePath = join(assetsRoot, 'skills', 'explainer-kit', 'scripts', 'lib', 'source-backlinks.mjs');
|
|
14
|
+
let loaded;
|
|
15
|
+
try {
|
|
16
|
+
loaded = (await import(pathToFileURL(modulePath).href));
|
|
17
|
+
}
|
|
18
|
+
catch (error) {
|
|
19
|
+
throw new CliError(`Bundled explainer source backlink contract could not be loaded: ${error instanceof Error ? error.message : String(error)}`, 2);
|
|
20
|
+
}
|
|
21
|
+
if (loaded.SOURCE_BACKLINK_CONTRACT_VERSION !==
|
|
22
|
+
SOURCE_BACKLINK_CONTRACT_VERSION ||
|
|
23
|
+
typeof loaded.parseCanonicalGithubBlobUrl !== 'function') {
|
|
24
|
+
throw new CliError(`Bundled assets must provide ${SOURCE_BACKLINK_CONTRACT_VERSION}.`, 2);
|
|
25
|
+
}
|
|
26
|
+
return loaded;
|
|
27
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { buildCommandContext, type CommandContext } from '../../../app/command-context.js';
|
|
2
2
|
import { type OatConfig, type OatLocalConfig } from '../../../config/oat-config.js';
|
|
3
|
-
import { resolveArchiveProjectTarget, resolvePrimaryRepoRoot, type ArchiveProjectOnCompletionOptions, type ArchiveProjectOnCompletionResult } from './archive-utils.js';
|
|
3
|
+
import { resolveArchiveProjectTarget, resolvePrimaryRepoRoot, verifySelectedProjectRecapForArchive, type ArchiveProjectOnCompletionOptions, type ArchiveProjectOnCompletionResult } from './archive-utils.js';
|
|
4
4
|
export interface ArchivePushOptions {
|
|
5
5
|
dryRun?: boolean;
|
|
6
6
|
projectRecapRun?: string;
|
|
@@ -13,6 +13,7 @@ export interface ProjectArchivePushCommandDependencies {
|
|
|
13
13
|
resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
|
|
14
14
|
resolvePrimaryRepoRoot: typeof resolvePrimaryRepoRoot;
|
|
15
15
|
resolveArchiveProjectTarget: typeof resolveArchiveProjectTarget;
|
|
16
|
+
verifySelectedProjectRecapForArchive: typeof verifySelectedProjectRecapForArchive;
|
|
16
17
|
archiveProjectOnCompletion: (options: ArchiveProjectOnCompletionOptions) => Promise<ArchiveProjectOnCompletionResult>;
|
|
17
18
|
processEnv: NodeJS.ProcessEnv;
|
|
18
19
|
timestamp: () => string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"push-runner.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/push-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAKL,2BAA2B,EAC3B,sBAAsB,
|
|
1
|
+
{"version":3,"file":"push-runner.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/push-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAKL,2BAA2B,EAC3B,sBAAsB,EACtB,oCAAoC,EAEpC,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EAEtC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qCAAqC;IACpD,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,2BAA2B,EAAE,OAAO,2BAA2B,CAAC;IAChE,oCAAoC,EAAE,OAAO,oCAAoC,CAAC;IAClF,0BAA0B,EAAE,CAC1B,OAAO,EAAE,iCAAiC,KACvC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,MAAM,CAAC;CACzB;AAmBD,wBAAgB,4CAA4C,IAAI,qCAAqC,CAcpG;AAkJD,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,qCAAqC,EACnD,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA0Ef"}
|
|
@@ -4,7 +4,7 @@ import { resolveProjectsRoot } from '../../shared/oat-paths.js';
|
|
|
4
4
|
import { readOatConfig, readOatLocalConfig, } from '../../../config/oat-config.js';
|
|
5
5
|
import { CliError } from '../../../errors/cli-error.js';
|
|
6
6
|
import { resolveProjectRoot } from '../../../fs/paths.js';
|
|
7
|
-
import { archiveProjectOnCompletion, assertDurableArchiveProjectTarget, buildArchiveSnapshotName, buildProjectArchiveS3Uri, resolveArchiveProjectTarget, resolvePrimaryRepoRoot, } from './archive-utils.js';
|
|
7
|
+
import { archiveProjectOnCompletion, assertDurableArchiveProjectTarget, buildArchiveSnapshotName, buildProjectArchiveS3Uri, resolveArchiveProjectTarget, resolvePrimaryRepoRoot, verifySelectedProjectRecapForArchive, } from './archive-utils.js';
|
|
8
8
|
export function defaultProjectArchivePushCommandDependencies() {
|
|
9
9
|
return {
|
|
10
10
|
buildCommandContext,
|
|
@@ -14,6 +14,7 @@ export function defaultProjectArchivePushCommandDependencies() {
|
|
|
14
14
|
resolveProjectsRoot,
|
|
15
15
|
resolvePrimaryRepoRoot,
|
|
16
16
|
resolveArchiveProjectTarget,
|
|
17
|
+
verifySelectedProjectRecapForArchive,
|
|
17
18
|
archiveProjectOnCompletion,
|
|
18
19
|
processEnv: process.env,
|
|
19
20
|
timestamp: () => new Date().toISOString(),
|
|
@@ -121,6 +122,9 @@ export async function runArchivePushCommand(dependencies, projectPathArg, option
|
|
|
121
122
|
timestamp: dependencies.timestamp,
|
|
122
123
|
});
|
|
123
124
|
assertDurableArchiveProjectTarget(archiveTarget);
|
|
125
|
+
if (options.projectRecapRun?.trim()) {
|
|
126
|
+
await dependencies.verifySelectedProjectRecapForArchive(target.projectPath, options.projectRecapRun.trim());
|
|
127
|
+
}
|
|
124
128
|
const dryRun = options.dryRun === true || context.dryRun;
|
|
125
129
|
if (dryRun) {
|
|
126
130
|
const report = await buildDryRunReport(dependencies, repoRoot, config, target, archiveTarget);
|
|
@@ -4,14 +4,20 @@ export interface PublicPackageContract {
|
|
|
4
4
|
role: 'cli' | 'docs-library' | 'support-library';
|
|
5
5
|
requiredMetadataFields: string[];
|
|
6
6
|
requiredPaths: string[];
|
|
7
|
+
requiredPackedTextFiles: PackedTextFileRequirement[];
|
|
7
8
|
forbiddenPathPatterns: string[];
|
|
8
9
|
versionPolicyAdditionalRoots: string[];
|
|
9
10
|
versionPolicyIgnorePatterns: string[];
|
|
10
11
|
}
|
|
12
|
+
export interface PackedTextFileRequirement {
|
|
13
|
+
path: string;
|
|
14
|
+
requiredContents: string[];
|
|
15
|
+
}
|
|
11
16
|
export declare function getPublicPackageContracts(): PublicPackageContract[];
|
|
12
17
|
export declare function findMissingMetadataFields(packageJson: Record<string, unknown>, contract: PublicPackageContract): string[];
|
|
13
18
|
export declare function findMissingPackedPaths(packedPaths: readonly string[], contract: PublicPackageContract): string[];
|
|
14
19
|
export declare function findForbiddenPackedPaths(packedPaths: readonly string[], contract: PublicPackageContract): string[];
|
|
20
|
+
export declare function findMissingPackedTextContents(packedTextFiles: Readonly<Record<string, string>>, contract: PublicPackageContract): string[];
|
|
15
21
|
export declare function findWorkspaceProtocolDependencySpecs(packageJson: Record<string, unknown>): string[];
|
|
16
22
|
export declare function findNonPublicWorkspaceDependencySpecs(packageJson: Record<string, unknown>, publicPackageNames: readonly string[], workspacePackageNames: readonly string[]): string[];
|
|
17
23
|
//# sourceMappingURL=public-package-contract.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"public-package-contract.d.ts","sourceRoot":"","sources":["../../src/release/public-package-contract.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACjD,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,2BAA2B,EAAE,MAAM,EAAE,CAAC;CACvC;
|
|
1
|
+
{"version":3,"file":"public-package-contract.d.ts","sourceRoot":"","sources":["../../src/release/public-package-contract.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACjD,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uBAAuB,EAAE,yBAAyB,EAAE,CAAC;IACrD,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,2BAA2B,EAAE,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AA2KD,wBAAgB,yBAAyB,IAAI,qBAAqB,EAAE,CAenE;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAMV;AAED,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACjD,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAoBV;AAED,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,EAAE,CAmBV;AAED,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,qBAAqB,EAAE,SAAS,MAAM,EAAE,GACvC,MAAM,EAAE,CA0BV"}
|