filegrc 0.8.0 → 0.9.0

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.
@@ -891,7 +891,11 @@ export async function planModelMigration(input = process.cwd(), options = {}) {
891
891
  const sourceVersion = String(loaded.workspace?.dataModelVersion || "");
892
892
  const requestedTarget = options.targetModelVersion
893
893
  ? String(options.targetModelVersion)
894
- : sourceVersion === "1" ? V1_TARGET_MODEL_VERSION : sourceVersion === "2" ? "3" : sourceVersion === "3" ? "4" : ACTIVE_MODEL_VERSION;
894
+ : sourceVersion === "1" ? V1_TARGET_MODEL_VERSION
895
+ : sourceVersion === "2" ? "3"
896
+ : sourceVersion === "3" ? "4"
897
+ : sourceVersion === "4" ? "5"
898
+ : ACTIVE_MODEL_VERSION;
895
899
  if (sourceVersion === requestedTarget) return emptyPlan(sourceVersion, requestedTarget);
896
900
  if (sourceVersion === "1" && requestedTarget === "2") {
897
901
  return planV1ToV2Migration(input, options);
@@ -902,13 +906,16 @@ export async function planModelMigration(input = process.cwd(), options = {}) {
902
906
  if (sourceVersion === "3" && requestedTarget === "4") {
903
907
  return planV3ToV4Migration(loaded, options);
904
908
  }
905
- if (sourceVersion === "4" && requestedTarget === ACTIVE_MODEL_VERSION) {
909
+ if (sourceVersion === "4" && requestedTarget === "5") {
906
910
  return planV4ToV5Migration(loaded, options);
907
911
  }
912
+ if (sourceVersion === "5" && requestedTarget === ACTIVE_MODEL_VERSION) {
913
+ return planV5ToV6Migration(loaded);
914
+ }
908
915
  if (sourceVersion === "1" && requestedTarget === ACTIVE_MODEL_VERSION) {
909
916
  throw new Error(
910
917
  "Model v1 workspaces must migrate to model v2 first. "
911
- + "Preview and apply `npx filegrc migrate --to-model 2`, then migrate one version at a time through model v5."
918
+ + "Preview and apply `npx filegrc migrate --to-model 2`, then migrate one version at a time through model v6."
912
919
  );
913
920
  }
914
921
  throw new Error(`Model migration does not support v${sourceVersion} to v${requestedTarget}.`);
@@ -1702,6 +1709,144 @@ async function planV4ToV5Migration(loaded, options = {}) {
1702
1709
  };
1703
1710
  }
1704
1711
 
1712
+ async function planV5ToV6Migration(loaded) {
1713
+ if (!loaded.workspace?.id) throw new Error("Model migration requires a valid Workspace record.");
1714
+ const targetModel = loadModel("6");
1715
+ const revisions = new Map(loaded.entries.map((entry) => [entry.record.id, contentRevision(entry.source)]));
1716
+ const automatic = [];
1717
+ const reviewRequired = [];
1718
+ const unsupported = [];
1719
+ const missing = [];
1720
+ const manualActions = [];
1721
+ const updates = [];
1722
+ const legacyTrainingIds = [];
1723
+ const removedTrainingScheduleFields = [];
1724
+ const obligations = loaded.resources.filter(({ type }) => type === "obligation");
1725
+
1726
+ for (const original of loaded.resources) {
1727
+ if (original.type === "workspace") {
1728
+ updates.push({ ...original, dataModelVersion: "6" });
1729
+ automatic.push(classifiedChange(
1730
+ "automatic",
1731
+ original.id,
1732
+ "dataModelVersion",
1733
+ "Select model v6 and enable separate Training approval and activation."
1734
+ ));
1735
+ continue;
1736
+ }
1737
+ if (original.type !== "training") continue;
1738
+ const record = { ...original };
1739
+ if (record.approvedByIds) {
1740
+ record.approverIds = record.approvedByIds;
1741
+ delete record.approvedByIds;
1742
+ automatic.push(classifiedChange(
1743
+ "automatic",
1744
+ record.id,
1745
+ "approverIds",
1746
+ "Use the common governed-content approver field."
1747
+ ));
1748
+ }
1749
+ if (record.effectiveContentRevisions) {
1750
+ record.approvedContentRevisions = record.effectiveContentRevisions;
1751
+ delete record.effectiveContentRevisions;
1752
+ automatic.push(classifiedChange(
1753
+ "automatic",
1754
+ record.id,
1755
+ "approvedContentRevisions",
1756
+ "Preserve the exact Training revision previously bound to approval and activation as the approved revision."
1757
+ ));
1758
+ }
1759
+ const removedSchedule = {};
1760
+ for (const field of ["assignmentTrigger", "completionWindowDays"]) {
1761
+ if (record[field] === undefined) continue;
1762
+ removedSchedule[field] = record[field];
1763
+ delete record[field];
1764
+ }
1765
+ if (Object.keys(removedSchedule).length) {
1766
+ const obligationIds = obligations.filter((obligation) => (
1767
+ obligation.templateResourceId === record.id
1768
+ || (obligation.scopeResourceIds || []).includes(record.id)
1769
+ )).map(({ id }) => id);
1770
+ removedTrainingScheduleFields.push({ trainingId: record.id, values: removedSchedule, obligationIds });
1771
+ reviewRequired.push(classifiedChange(
1772
+ "review-required",
1773
+ record.id,
1774
+ "assignmentSchedule",
1775
+ `Training assignment schedules now belong only in Obligations. Confirm the removed ${Object.keys(removedSchedule).join(" and ")} values against ${obligationIds.length ? obligationIds.join(", ") : "a new Step 3 Obligation"}.`
1776
+ ));
1777
+ }
1778
+ if (record.status === "draft" && record.effectiveOn) {
1779
+ record.proposedEffectiveOn = record.effectiveOn;
1780
+ delete record.effectiveOn;
1781
+ reviewRequired.push(classifiedChange(
1782
+ "review-required",
1783
+ record.id,
1784
+ "proposedEffectiveOn",
1785
+ "Keep the draft Training date as proposed until the approved revision is activated in Step 3."
1786
+ ));
1787
+ }
1788
+ if (["active", "retired"].includes(record.status) && record.approvedContentRevisions) {
1789
+ record.activationBasis = "legacy-v5";
1790
+ legacyTrainingIds.push(record.id);
1791
+ reviewRequired.push(classifiedChange(
1792
+ "review-required",
1793
+ record.id,
1794
+ "activationBasis",
1795
+ "Preserve the combined model v5 Training approval and activation as legacy-v5. The migration does not invent a separate activation actor, date, or revision."
1796
+ ));
1797
+ }
1798
+ updates.push(record);
1799
+ }
1800
+
1801
+ const updatedById = new Map(updates.map((record) => [record.id, record]));
1802
+ const migratedRecords = loaded.resources.map((record) => updatedById.get(record.id) || record);
1803
+ await collectTargetValidationActions(loaded, migratedRecords, targetModel, missing, manualActions);
1804
+ for (const item of [...missing, ...manualActions]) {
1805
+ unsupported.push(classifiedChange(
1806
+ "unsupported",
1807
+ item.resourceId,
1808
+ item.field,
1809
+ item.message || `Resolve ${item.field} before applying the model v6 migration.`
1810
+ ));
1811
+ }
1812
+ const ready = unsupported.length === 0;
1813
+ return {
1814
+ schemaVersion: 2,
1815
+ sourceModelVersion: "5",
1816
+ targetModelVersion: "6",
1817
+ ready,
1818
+ missing,
1819
+ conflicts: [],
1820
+ manualActions,
1821
+ classifications: { automatic, reviewRequired, unsupported },
1822
+ notes: reviewRequired,
1823
+ migrationReport: { legacyTrainingIds, removedTrainingScheduleFields },
1824
+ summary: {
1825
+ create: 0,
1826
+ update: updates.length,
1827
+ automatic: automatic.length,
1828
+ reviewRequired: reviewRequired.length,
1829
+ unsupported: unsupported.length
1830
+ },
1831
+ fileDiff: {
1832
+ create: [],
1833
+ update: updates.map((record) => ({
1834
+ type: record.type,
1835
+ id: record.id,
1836
+ before: loaded.resources.find(({ id }) => id === record.id),
1837
+ after: record
1838
+ }))
1839
+ },
1840
+ changes: {
1841
+ create: [],
1842
+ update: updates,
1843
+ expectedRevisions: Object.fromEntries(updates.map(({ id }) => [id, revisions.get(id)])),
1844
+ validateWholeWorkspace: true,
1845
+ targetModelVersion: "6"
1846
+ }
1847
+ };
1848
+ }
1849
+
1705
1850
  function normalizeDocumentScopeDecision(value) {
1706
1851
  const candidate = typeof value === "object" && value
1707
1852
  ? value.workflowScope || value.scope
@@ -14,7 +14,7 @@ import {
14
14
  } from "./recurrence.js";
15
15
  import { currentCalendarDate, isRfc3339Timestamp } from "./time.js";
16
16
  import { loadWorkspace } from "./workspace.js";
17
- import { obligationGovernedDocuments, obligationProgramStatus } from "./program-lifecycle.js";
17
+ import { obligationGovernedContent, obligationProgramStatus } from "./program-lifecycle.js";
18
18
  import { resolveProgram } from "./program.js";
19
19
 
20
20
  const COMPLETION_DATE_FIELDS = [
@@ -259,7 +259,7 @@ export async function createObligationEvent(input, options) {
259
259
  ));
260
260
  if (!eventType || templates.length === 0) throw new Error(`No active obligations use event type "${eventType}".`);
261
261
  if (templates.some((record) => obligationProgramStatus(record, byId, occurredOn, loaded.model) === "proposed")) {
262
- throw new Error(`Event type "${eventType}" still has starter proposals. Make every governing Policy and required governed Document active and effective, then implement at least one linked Control before starting this workflow.`);
262
+ throw new Error(`Event type "${eventType}" still has starter proposals. Make every governing Policy and required governed-content record active and effective, then implement at least one linked Control before starting this workflow.`);
263
263
  }
264
264
  if (templates.some((record) => normalizedEventWindow(record.window).precision === "timestamp") && !occurredAt) {
265
265
  throw new Error(`Event type "${eventType}" has hour-based deadlines and requires an RFC 3339 occurredAt timestamp.`);
@@ -997,10 +997,10 @@ function obligationActivationDate(obligation, byId, model) {
997
997
  .filter((policy) => policy?.type === "policy")
998
998
  .map((policy) => policy.effectiveOn)
999
999
  .filter(Boolean);
1000
- const documentDates = obligationGovernedDocuments(obligation, byId, model)
1001
- .map((document) => document.effectiveOn)
1000
+ const governedContentDates = obligationGovernedContent(obligation, byId, model)
1001
+ .map((record) => record.effectiveOn)
1002
1002
  .filter(Boolean);
1003
- return [...policyDates, ...documentDates].sort().at(-1) || null;
1003
+ return [...policyDates, ...governedContentDates].sort().at(-1) || null;
1004
1004
  }
1005
1005
 
1006
1006
  function relativeTiming(window, asOf) {
@@ -515,8 +515,11 @@ async function buildPolicyLibraryPlan(loaded) {
515
515
  const source = await readResourceSource(loaded, TRAINING_CONTENT_PATH);
516
516
  const rawSourceRevision = contentRevision(source);
517
517
  const sourceRevision = normalizedTrainingRevision(source, loaded.workspace?.organizationName);
518
- if (["active", "retired"].includes(trainingEntry.record.status)) {
519
- skipped.push(skippedItem(TRAINING_ID, "adopted", "Active and retired Training content is never changed by a starter-library proposal."));
518
+ const adoptedStatuses = modelSupports(loaded.model, "governed-training-activation")
519
+ ? ["approved", "active", "superseded", "retired"]
520
+ : ["active", "retired"];
521
+ if (adoptedStatuses.includes(trainingEntry.record.status)) {
522
+ skipped.push(skippedItem(TRAINING_ID, "adopted", "Approved, active, superseded, and retired Training content is never changed by a starter-library proposal."));
520
523
  } else if (sourceRevision === CURRENT_TRAINING_REVISION) {
521
524
  skipped.push(skippedItem(TRAINING_ID, "current", "The Security Awareness Training already contains the current starter language."));
522
525
  } else if (!PRIOR_TRAINING_REVISIONS.has(sourceRevision)) {
@@ -38,6 +38,31 @@ export function governedDocumentIsOperating(document, asOf, model) {
38
38
  );
39
39
  }
40
40
 
41
+ export function governedTrainingIsOperating(training, asOf, model) {
42
+ if (training?.type !== "training" || training.status !== "active") return false;
43
+ if (!training.effectiveOn || training.effectiveOn > asOf) return false;
44
+ if (!modelSupports(model, "governed-training-activation")) return true;
45
+ if (training.activationBasis === "legacy-v5") {
46
+ return Boolean(training.approvedOn && training.approvedContentRevisions);
47
+ }
48
+ return Boolean(
49
+ training.activationBasis === "recorded"
50
+ && training.approvedOn
51
+ && training.approvedContentRevisions
52
+ && training.activatedOn
53
+ && training.activatedOn <= asOf
54
+ && (training.activatedByIds || []).length
55
+ && training.activatedContentRevisions
56
+ && contentRevisionBindingsMatch(training.approvedContentRevisions, training.activatedContentRevisions)
57
+ );
58
+ }
59
+
60
+ export function governedContentIsOperating(record, asOf, model) {
61
+ if (record?.type === "document") return governedDocumentIsOperating(record, asOf, model);
62
+ if (record?.type === "training") return governedTrainingIsOperating(record, asOf, model);
63
+ return false;
64
+ }
65
+
41
66
  export function contentRevisionBindingsMatch(left, right) {
42
67
  if (!left || !right || Array.isArray(left) || Array.isArray(right)) return false;
43
68
  const normalize = (value) => Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b)));
@@ -66,6 +91,19 @@ export function obligationGovernedDocuments(obligation, byId, model) {
66
91
  ));
67
92
  }
68
93
 
94
+ export function obligationGovernedContent(obligation, byId, model) {
95
+ const documents = obligationGovernedDocuments(obligation, byId, model);
96
+ if (!modelSupports(model, "governed-training-activation")) return documents;
97
+ const directIds = [
98
+ ...(obligation.scopeResourceIds || []),
99
+ ...(obligation.templateResourceId ? [obligation.templateResourceId] : [])
100
+ ];
101
+ const training = [...new Set(directIds)]
102
+ .map((id) => byId.get(id))
103
+ .filter((record) => record?.type === "training" && !["superseded", "retired"].includes(record.status));
104
+ return [...documents, ...training];
105
+ }
106
+
69
107
  function indexRequiredDocumentsByControl(byId, model) {
70
108
  const modelVersion = String(model?.modelVersion || "");
71
109
  const cached = requiredDocumentsByControlCache.get(byId);
@@ -99,9 +137,9 @@ export function obligationProgramStatus(obligation, byId, asOf, model) {
99
137
  && policy.effectiveOn <= asOf;
100
138
  });
101
139
  if (!policiesReady) return "proposed";
102
- const governedDocumentsReady = obligationGovernedDocuments(obligation, byId, model)
103
- .every((document) => governedDocumentIsOperating(document, asOf, model));
104
- if (!governedDocumentsReady) return "proposed";
140
+ const governedContentReady = obligationGovernedContent(obligation, byId, model)
141
+ .every((record) => governedContentIsOperating(record, asOf, model));
142
+ if (!governedContentReady) return "proposed";
105
143
  const controlIds = obligation.controlIds || [];
106
144
  if (!controlIds.length) return "accepted";
107
145
  return controlIds.some((id) => byId.get(id)?.type === "control" && byId.get(id).status === "implemented")
@@ -12,7 +12,7 @@ export const RESOURCE_INSTRUCTIONS = {
12
12
  requirement: "Keep the published criterion as catalog content. Record management applicability and rationale on the selected Program.",
13
13
  commitment: "Record supplemental customer promises and service requirements that shape the scope or control design. The Commitment’s systemIds and controlIds are authoritative for what fulfills it.",
14
14
  policy: "Tailor each Policy to match what the company is committing to. Clear placeholders, assign an owner and separate approver, then bind approval to the reviewed content. Approval does not prove implementation. Activate the Policy during the Step 3 cutover after reviewing its implementation gaps.",
15
- document: "Complete required governed plans and schedules in Step 2, assign an owner and separate approver, and bind approval to the intended values and exact Markdown. Implement the linked requirements and activate that approved revision in Step 3. Prepare audit-specific Documents in Step 5.",
15
+ document: "Complete required program Documents in Step 2, assign an owner and separate approver, and bind approval to the intended values and exact Markdown. Implement the linked requirements and activate that approved revision in Step 3. Prepare Audit Documents in Step 5.",
16
16
  control: "Finish each applicable starter Control with the procedure people follow, its owner, bounded System scope, operating Components, authoritative evidence-source Components, governing Policy and Requirement mappings, and implementation date. Put calendar and event schedules in Obligations.",
17
17
  "complementary-control": "Review whether any in-scope Control depends on a customer or carved-out provider action. Record each real dependency, or confirm that the current scope has none.",
18
18
  evidence: "Create an Evidence Artifact when a real export, report, screenshot, signed file, or approved external reference exists. Select its authoritative source Component, link the Controls and operating records it supports, retain the fixed artifact or reference, and have another person verify it before audit use.",
@@ -28,7 +28,7 @@ export const RESOURCE_INSTRUCTIONS = {
28
28
  "access-grant": "Record each person’s or service account’s access to a Component, including approval, provisioning, changes, and removal.",
29
29
  "access-review": "Review access on schedule, record each decision, and assign any access changes that result.",
30
30
  "service-account": "Catalog non-human accounts that need separate tracking, including their owner, purpose, System, privilege, and expiry.",
31
- training: "Maintain the training content people must complete, along with its audience, timing, and passing requirements.",
31
+ training: "Review and approve the exact Training content in Step 2, then activate the unchanged revision during Step 3 after its linked Controls and assignment Obligations are ready.",
32
32
  attestation: "Record each person’s completion or acknowledgement against the exact policy or training revision.",
33
33
  "vulnerability-scan": "Record each required scan, including its scope, timing, result, and evidence.",
34
34
  vulnerability: "Track confirmed weaknesses that need separate remediation, acceptance, or closure.",
@@ -98,20 +98,21 @@ export const PROGRAM_PATH = [
98
98
  {
99
99
  id: "policies",
100
100
  number: 2,
101
- title: "Approve Policies and Plans",
102
- description: "Tailor requirements, intended values, and approvals",
103
- summary: "Adapt and independently approve Policies and required governed Documents.",
101
+ title: "Approve Policies",
102
+ description: "Review governed content and approvals",
103
+ summary: "Review and independently approve Policies, program Documents, and Training content.",
104
104
  sections: [
105
- { id: "library", title: "Policy Library", description: "Review and approve Policy requirements without treating approval as proof of technical implementation.", steps: ["Review Policy Markdown and replace every organization placeholder.", "Confirm the owner, separate approver, audience, review Obligation, and Controls that point to the Policy.", "Record approval against the exact reviewed content. Leave the Policy approved and inactive until the Step 3 implementation cutover."], types: ["policy"], defaultOpen: true },
106
- { id: "governed-documents", title: "Governed Plans and Schedules", description: "Complete the intended values in each required program plan or schedule and obtain independent approval of the exact revision before implementation.", steps: ["Review each required plan or schedule and replace every organization placeholder with the intended owner, timing, threshold, scope, or response value.", "Confirm the Document owner, separate approver, linked Controls, and review schedule.", "Record approval and its date against the exact Markdown revision. Leave the Document approved until its linked requirements are implemented in Step 3."], types: [], relatedLinks: [{ type: "document", label: "Governed plans and schedules", href: "#/resources/document?stage=policies&documentScope=program" }], defaultOpen: true }
105
+ { id: "policy-content", title: "Policies", description: "Review every program Policy, Document, and Training record in one table, then bind independent approval to each exact revision.", steps: ["Review each governed Markdown artifact and replace every organization placeholder.", "Confirm the owner, separate approver, linked Controls, audience, and intended values that apply to each artifact.", "Record approval and its date against the exact revision. Leave approved content inactive until its Step 3 implementation cutover."], types: [], relatedLinks: [{ type: "policy", label: "Policies", href: "#/stage/policies" }], defaultOpen: true }
107
106
  ],
108
- resourceTypes: ["policy"],
109
- supportingResourceTypes: ["document"],
107
+ resourceTypes: [],
108
+ supportingResourceTypes: ["policy", "document", "training"],
110
109
  commands: [
111
110
  "filegrc guide policy --json",
112
111
  "filegrc guide document --json",
112
+ "filegrc guide training --json",
113
113
  "filegrc list policy --json",
114
114
  "filegrc list document --json",
115
+ "filegrc list training --json",
115
116
  "filegrc get POLICY_ID --mutation"
116
117
  ]
117
118
  },
@@ -122,15 +123,17 @@ export const PROGRAM_PATH = [
122
123
  description: "Finish controls and their evidence sources",
123
124
  summary: "Describe each Control and connect its evidence source.",
124
125
  sections: [
125
- { id: "catalog", title: "Control Catalog", description: "Implement the approved requirements, activate required governed Documents, finish the authoritative evidence sources, then review the approved Policies together at implementation cutover.", steps: ["Open every planned Control and confirm its mappings and operation pattern.", "Write the real procedure in Record Markdown, add bounded System scope, and map the operating and authoritative evidence-source Components.", "Create or enable every calendar and event schedule as an Obligation. Enabled work remains dormant until its governing Policy is active.", "Confirm each source Component is active, has an evidence-source role and rationale in the Control's System scope, has current access owners, and includes repeatable retrieval instructions in Record Markdown.", "Implement every requirement linked from an approved governed plan or schedule, then activate the unchanged approved Document with a separate activation date and revision.", "Use Review policy activation on the Controls page to inspect each Policy’s planned or partial Controls, inactive governed Documents, missing Components or sources, missing schedules, and unresolved Exceptions.", "Choose the approved Policies that should take effect, set the real effective date, and confirm the Step 3 cutover. You can activate with a documented gap or approved Exception, but Evidence Readiness still requires active and operating Policies and Documents."], types: ["control", "complementary-control"], relatedLinks: [{ type: "document", label: "Activate governed plans and schedules", href: "#/resources/document?stage=controls&documentScope=program" }], defaultOpen: true }
126
+ { id: "catalog", title: "Control Catalog", description: "Implement approved requirements, configure Obligations, activate approved program content, finish authoritative evidence sources, then activate the Policies at cutover.", steps: ["Open every planned Control and confirm its mappings and operation pattern.", "Write the real procedure in Record Markdown, add bounded System scope, and map the operating and authoritative evidence-source Components.", "Review and enable every calendar and event schedule as an Obligation. Enabled work remains dormant until its governing Policy is active.", "Confirm each source Component is active, has an evidence-source role and rationale in the Control's System scope, has current access owners, and includes repeatable retrieval instructions in Record Markdown.", "Implement every requirement linked from an approved program Document or Training record, then activate the unchanged approved revisions with separate activation dates and bindings.", "Use the activation review to inspect planned or partial Controls, inactive governed content, missing Components or sources, missing schedules, and unresolved Exceptions.", "Choose the approved Policies that should take effect, set the real effective date, and confirm the Step 3 cutover."], types: ["control", "complementary-control", "obligation"], defaultOpen: true }
126
127
  ],
127
- resourceTypes: ["control", "complementary-control"],
128
+ resourceTypes: ["control", "complementary-control", "obligation"],
128
129
  commands: [
129
130
  "filegrc guide control --json",
130
131
  "filegrc list control --json",
131
132
  "filegrc get CONTROL_ID --mutation",
133
+ "filegrc guide obligation --json",
134
+ "filegrc list obligation --json",
132
135
  "filegrc review-collection complementary-control --scaffold",
133
- "filegrc activate-documents --scaffold",
136
+ "filegrc activate-content --scaffold",
134
137
  "filegrc activate-policies --scaffold",
135
138
  "filegrc evidence-map --json",
136
139
  "filegrc program-readiness --json"
@@ -144,11 +147,11 @@ export const PROGRAM_PATH = [
144
147
  summary: "Complete scheduled and event work. Keep dated proof.",
145
148
  sections: [
146
149
  { id: "risk", title: "Risk", description: "Maintain the program’s risk assessments and risk register as the service, threats, suppliers, and control needs change.", steps: ["Complete and approve risk assessments on schedule and after material changes.", "Record risks that need treatment, acceptance, or ongoing tracking.", "Add or update controls when the assessment identifies a new or changed response."], types: ["risk-assessment", "risk"], defaultOpen: true },
147
- { id: "queue", title: "Work Queue", description: "Complete recurring work, Policy Event tasks, and assigned follow-up within their required windows.", steps: ["Review proposed work while policies are drafts.", "Complete due work within its allowed window and link dated proof.", "Start Policy Events when hiring, departures, incidents, or material changes occur; every other open Action Item appears here automatically."], types: ["obligation", "obligation-event", "data-request"], utility: "obligation-board", defaultOpen: true },
150
+ { id: "queue", title: "Work Queue", description: "Complete recurring occurrences, Policy Event tasks, and assigned follow-up within their required windows.", steps: ["Complete due work within its allowed window and link dated proof.", "Start Policy Events when hiring, departures, incidents, or material changes occur.", "Resolve every other open Action Item from the same queue."], types: ["obligation-event", "data-request"], utility: "obligation-board", defaultOpen: true },
148
151
  { id: "evidence", title: "Evidence Artifacts", description: "Create records only for real exports, reports, screenshots, signed files, or approved external references collected during operation.", steps: ["Create an Evidence Artifact when the artifact exists or an operating record needs fixed supporting proof.", "Select the authoritative source Component, link the Controls and source operating record, and retain the fixed attachment or approved reference.", "Record the collector and Classification, then have another person verify the artifact before audit use."], types: ["evidence"], defaultOpen: true },
149
152
  { id: "governance", title: "Governance", description: "Record formal reviews, oversight meetings, and approved policy or control exceptions.", steps: ["Complete scheduled policy reviews and oversight meetings.", "Record decisions, attendees, follow-up work, and evidence.", "Approve time-bound exceptions before the departure begins."], types: ["policy-review", "meeting", "exception"], defaultOpen: false },
150
153
  { id: "inventories", title: "Assets and Vendors", description: "Maintain the asset inventory and recurring reviews of supplier relationships during operation.", steps: ["Keep ownership, custody, status, and lifecycle current for important assets.", "Perform vendor reviews on schedule and after material supplier changes.", "Link fixed reports and review evidence to the operating records."], types: ["asset", "vendor-review"], defaultOpen: false },
151
- { id: "access-training", title: "Access and Training", description: "Inventory service accounts before recording access decisions, periodic reviews, assignments, and acknowledgements.", steps: ["Catalog service accounts that need separate tracking.", "Preserve access approvals and removals as they occur, then complete periodic access reviews and resolve exceptions.", "Assign training and retain acknowledgement evidence for the exact content revision."], types: ["service-account", "access-grant", "access-review", "training", "attestation"], defaultOpen: false },
154
+ { id: "access-training", title: "Access and Training Completion", description: "Inventory service accounts and retain access decisions, Training assignments, and acknowledgements produced during operation.", steps: ["Catalog service accounts that need separate tracking.", "Preserve access approvals and removals as they occur, then complete periodic access reviews and resolve exceptions.", "Retain each Training assignment and Attestation against the exact active content revision."], types: ["service-account", "access-grant", "access-review", "attestation"], defaultOpen: false },
152
155
  { id: "security", title: "Security Operations", description: "Record vulnerability work, applicable penetration testing, and incident response activity for the period.", steps: ["Retain scan scope, results, vulnerabilities, remediation, and exceptions.", "When the approved applicability review requires penetration testing, record the test and follow-up findings.", "Start the incident workflow when a qualifying event occurs."], types: ["vulnerability-scan", "vulnerability", "penetration-test", "incident"], defaultOpen: false },
153
156
  { id: "resilience", title: "Resilience", description: "Preserve proof that backups, restoration, continuity, and incident exercises work as designed.", steps: ["Record backup restoration tests and their results.", "Run continuity and incident exercises on schedule.", "Assign and close follow-up work from failed objectives or lessons learned."], types: ["backup-test", "exercise"], defaultOpen: false },
154
157
  { id: "issues", title: "Issues and Remediation", description: "Keep observations in the source report and track only confirmed gaps that need a separate remediation lifecycle.", steps: ["Create a Finding only when a confirmed gap needs its own owner, due date, status, or verified closure.", "Use the Finding itself for straightforward remediation; create Action Items only for separate assigned tasks.", "Work Action Items from Work Queue and close the Finding only after remediation is independently verified."], types: ["finding"], defaultOpen: false }
@@ -156,7 +159,6 @@ export const PROGRAM_PATH = [
156
159
  resourceTypes: [
157
160
  "risk-assessment",
158
161
  "risk",
159
- "obligation",
160
162
  "obligation-event",
161
163
  "data-request",
162
164
  "evidence",
@@ -168,7 +170,6 @@ export const PROGRAM_PATH = [
168
170
  "service-account",
169
171
  "access-grant",
170
172
  "access-review",
171
- "training",
172
173
  "attestation",
173
174
  "vulnerability-scan",
174
175
  "vulnerability",
@@ -222,7 +223,7 @@ export const PROGRAM_PATH = [
222
223
  summary: "Track the CPA engagement, fieldwork, and evidence packet.",
223
224
  sections: [
224
225
  { id: "engagement", title: "Engagement", description: "Record the actual CPA engagement, formal scope and dates, requests, and management responses.", steps: ["Create the Audit after the CPA firm is engaged.", "Record the firm-agreed type, scope, systems, criteria, and dates.", "Track incoming requests and approved response material."], types: ["audit", "audit-request"], defaultOpen: true },
225
- { id: "fieldwork", title: "Fieldwork", description: "Prepare audit-specific Documents, reconcile Type 2 populations, review both evidence paths, support testing, and build the indexed packet.", steps: ["Initialize and complete engagement-specific management Documents and populations.", "Approve and activate each audit-specific Document only when its engagement facts and timing are final.", "Review dated FileGRC operating records and verified Evidence Artifacts for the formal period.", "Reconcile complete populations, link samples, and resolve fieldwork requests and Findings.", "Build the packet from a clean Git revision; it includes FileGRC records, Markdown, Evidence Artifacts, attachments, indexes, history, and checksums."], types: ["audit-population", "control-test"], relatedLinks: [{ type: "document", label: "Audit-specific Documents", href: "#/resources/document?stage=audit&documentScope=audit" }], utility: "audit-packet", defaultOpen: true }
226
+ { id: "fieldwork", title: "Fieldwork", description: "Prepare Audit Documents, reconcile Type 2 populations, review both evidence paths, support testing, and build the indexed packet.", steps: ["Initialize and complete engagement-specific management Documents and populations.", "Approve and activate each Audit Document only when its engagement facts and timing are final.", "Review dated FileGRC operating records and verified Evidence Artifacts for the formal period.", "Reconcile complete populations, link samples, and resolve fieldwork requests and Findings.", "Build the packet from a clean Git revision; it includes FileGRC records, Markdown, Evidence Artifacts, attachments, indexes, history, and checksums."], types: ["audit-population", "control-test"], relatedLinks: [{ type: "document", label: "Audit Documents", href: "#/resources/document?stage=audit&documentScope=audit" }], utility: "audit-packet", defaultOpen: true }
226
227
  ],
227
228
  resourceTypes: ["audit", "audit-request", "audit-population", "control-test"],
228
229
  utilities: [