diff --git a/SPEC.md b/SPEC.md index c06e3ee..b6c12ca 100644 --- a/SPEC.md +++ b/SPEC.md @@ -481,7 +481,7 @@ case it is not a path. Each path-valued field accepts: A `references/` subdirectory conventionally mirrors external material, run instructions, or code as first-class concepts within the bundle. Sources, executors, and attesters commonly point into it (for example -`references/attesters/revenue.py`). It is a naming convention, not a +`/references/attesters/revenue.py`). It is a naming convention, not a requirement. --- @@ -617,10 +617,10 @@ runtime: bigquery parameters: - { name: year, type: integer, required: true } executor: - resource: references/skills/run-on-bq.md + resource: /references/skills/run-on-bq.md receipt: [job_id, executed_sql, result] attester: - resource: references/attesters/revenue.py + resource: /references/attesters/revenue.py generated: { by: reference_agent/gemini-2.5-pro, at: 2026-06-20T22:53:05Z } verified: { by: human:ahormati, at: 2026-06-25T09:00:00Z } stale_after: 2026-09-23T00:00:00Z @@ -654,7 +654,7 @@ Provide the computation in one of two ways: ```yaml runtime: bigquery -computation: references/computations/lib/revenue.sql +computation: /references/computations/lib/revenue.sql parameters: - { name: year, type: integer, required: true } ``` diff --git a/bundles/acme_retail/computations/gross-margin-period.md b/bundles/acme_retail/computations/gross-margin-period.md index f017263..ba12024 100644 --- a/bundles/acme_retail/computations/gross-margin-period.md +++ b/bundles/acme_retail/computations/gross-margin-period.md @@ -8,10 +8,10 @@ parameters: - { name: period_start, type: date, required: true } - { name: period_end, type: date, required: true } executor: - resource: skills/run-on-bq.md + resource: /skills/run-on-bq.md receipt: [job_id, executed_sql, result] attester: - resource: attesters/sql_equality.py + resource: /attesters/sql_equality.py generated: { by: reference_agent/gemini-2.5-pro, at: 2026-06-30T14:00:00Z } verified: - { by: human:jsmith@acme, at: 2026-07-01T09:00:00Z } @@ -19,12 +19,12 @@ status: stable stale_after: 2026-12-31T00:00:00Z sources: - id: margin-standard - resource: policies/margin-standard.md + resource: /policies/margin-standard.md title: Cost Allocation & Margin Standard (FY2026) author: human:jsmith@acme last_modified: 2026-06-15T00:00:00Z - id: revenue-policy - resource: policies/revenue-recognition.md + resource: /policies/revenue-recognition.md title: Revenue Recognition Policy (FY2026) author: human:jsmith@acme last_modified: 2026-06-15T00:00:00Z diff --git a/bundles/acme_retail/computations/revenue-ytd.md b/bundles/acme_retail/computations/revenue-ytd.md index 8a23558..376e0d3 100644 --- a/bundles/acme_retail/computations/revenue-ytd.md +++ b/bundles/acme_retail/computations/revenue-ytd.md @@ -7,10 +7,10 @@ runtime: bigquery parameters: - { name: year, type: integer, required: true } executor: - resource: skills/run-on-bq.md + resource: /skills/run-on-bq.md receipt: [job_id, executed_sql, result] attester: - resource: attesters/sql_equality.py + resource: /attesters/sql_equality.py generated: { by: reference_agent/gemini-2.5-pro, at: 2026-06-30T14:00:00Z } verified: - { by: human:jsmith@acme, at: 2026-07-01T09:00:00Z } @@ -18,12 +18,12 @@ status: stable stale_after: 2026-12-31T00:00:00Z sources: - id: revenue-policy - resource: policies/revenue-recognition.md + resource: /policies/revenue-recognition.md title: Revenue Recognition Policy (FY2026) author: human:jsmith@acme last_modified: 2026-06-15T00:00:00Z - id: orders-table - resource: tables/orders.md + resource: /tables/orders.md title: Customer Orders (BigQuery table) author: team:data-platform last_modified: 2026-07-01T00:00:00Z diff --git a/bundles/acme_retail/metrics/gross-margin.md b/bundles/acme_retail/metrics/gross-margin.md index 1ab58d6..3c29264 100644 --- a/bundles/acme_retail/metrics/gross-margin.md +++ b/bundles/acme_retail/metrics/gross-margin.md @@ -14,12 +14,12 @@ not: instead: "revenue minus full COGS (product cost + inbound fulfillment + outbound shipping + payment fees)" sources: - id: margin-standard - resource: policies/margin-standard.md + resource: /policies/margin-standard.md title: Cost Allocation & Margin Standard (FY2026) author: human:jsmith@acme last_modified: 2026-06-15T00:00:00Z - id: revenue-policy - resource: policies/revenue-recognition.md + resource: /policies/revenue-recognition.md title: Revenue Recognition Policy (FY2026) author: human:jsmith@acme last_modified: 2026-06-15T00:00:00Z diff --git a/bundles/acme_retail/metrics/revenue.md b/bundles/acme_retail/metrics/revenue.md index 9f9b12e..a5cfcfe 100644 --- a/bundles/acme_retail/metrics/revenue.md +++ b/bundles/acme_retail/metrics/revenue.md @@ -10,7 +10,7 @@ status: stable stale_after: 2026-12-31T00:00:00Z sources: - id: revenue-policy - resource: policies/revenue-recognition.md + resource: /policies/revenue-recognition.md title: Revenue Recognition Policy (FY2026) author: human:jsmith@acme last_modified: 2026-06-15T00:00:00Z diff --git a/bundles/acme_retail/tables/orders.md b/bundles/acme_retail/tables/orders.md index 25e5643..8966015 100644 --- a/bundles/acme_retail/tables/orders.md +++ b/bundles/acme_retail/tables/orders.md @@ -17,7 +17,7 @@ sources: usage_count: 1240 last_modified: 2026-06-15T00:00:00Z - id: revenue-policy - resource: policies/revenue-recognition.md + resource: /policies/revenue-recognition.md title: Revenue Recognition Policy (FY2026) author: human:jsmith@acme last_modified: 2026-06-15T00:00:00Z