@c4a/context-cli 0.7.10-alpha.2 → 0.7.10

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 (49) hide show
  1. package/cli.js +1154 -754
  2. package/indexers/bundles/context-code-indexer/references/indexer.md +14 -0
  3. package/indexers/bundles/context-code-indexer/templates/adapter-integration.md +1 -1
  4. package/indexers/bundles/context-code-indexer/templates/api-service.md +1 -1
  5. package/indexers/bundles/context-code-indexer/templates/background-runtime.md +1 -1
  6. package/indexers/bundles/context-code-indexer/templates/cli-tool.md +1 -1
  7. package/indexers/bundles/context-code-indexer/templates/component-library.md +4 -4
  8. package/indexers/bundles/context-code-indexer/templates/contract-source.md +1 -1
  9. package/indexers/bundles/context-code-indexer/templates/data-sync-reconciliation.md +6 -8
  10. package/indexers/bundles/context-code-indexer/templates/domain-service.md +1 -1
  11. package/indexers/bundles/context-code-indexer/templates/monorepo-container.md +1 -1
  12. package/indexers/bundles/context-code-indexer/templates/sdk-library.md +1 -2
  13. package/indexers/bundles/context-code-indexer/templates/web-application.md +1 -1
  14. package/indexers/contracts/profile-contract.json +245 -245
  15. package/indexers/release-manifest.json +14 -14
  16. package/package.json +12 -12
  17. package/parserEntryWorker.js +17 -8
  18. package/plugins/VERSION +1 -1
  19. package/plugins/claude/.claude-plugin/plugin.json +1 -1
  20. package/plugins/claude/commands/context.md +37 -73
  21. package/plugins/codex/.codex-plugin/plugin.json +2 -2
  22. package/plugins/codex/skills/context/SKILL.md +37 -73
  23. package/plugins/cursor/.cursor-plugin/plugin.json +1 -1
  24. package/plugins/cursor/commands/c4a-context.md +37 -73
  25. package/plugins/skills/context/SKILL.md +37 -73
  26. package/plugins/skills/context-code-indexer/references/indexer.md +14 -0
  27. package/plugins/skills/context-code-indexer/templates/adapter-integration.md +1 -1
  28. package/plugins/skills/context-code-indexer/templates/api-service.md +1 -1
  29. package/plugins/skills/context-code-indexer/templates/background-runtime.md +1 -1
  30. package/plugins/skills/context-code-indexer/templates/cli-tool.md +1 -1
  31. package/plugins/skills/context-code-indexer/templates/component-library.md +4 -4
  32. package/plugins/skills/context-code-indexer/templates/contract-source.md +1 -1
  33. package/plugins/skills/context-code-indexer/templates/data-sync-reconciliation.md +6 -8
  34. package/plugins/skills/context-code-indexer/templates/domain-service.md +1 -1
  35. package/plugins/skills/context-code-indexer/templates/monorepo-container.md +1 -1
  36. package/plugins/skills/context-code-indexer/templates/sdk-library.md +1 -2
  37. package/plugins/skills/context-code-indexer/templates/web-application.md +1 -1
  38. package/providers/context/manifest.json +20 -20
  39. package/providers/context/provider.yaml +1 -1
  40. package/providers/context/resources/manuals/guides/indexer-provider-and-customization.md +0 -2
  41. package/providers/context/resources/manuals/guides/knowledge-updates.md +28 -2
  42. package/providers/context/resources/manuals/guides/workspace-prepare.md +17 -0
  43. package/providers/context/resources/manuals/reference/project-api.md +37 -17
  44. package/providers/context/resources/procedures/close-and-build.md +21 -0
  45. package/providers/context/resources/procedures/knowledge-updates.md +28 -2
  46. package/providers/context/resources/procedures/production-stage-files.md +14 -0
  47. package/providers/context/resources/procedures/source-capture-detailed.md +16 -2
  48. package/providers/context/resources/procedures/work-start-report.md +10 -4
  49. package/providers/context/resources/procedures/workspace-prepare.md +17 -0
@@ -61,6 +61,20 @@ returned action; accepted content needs a revision task.
61
61
 
62
62
  ## Writing follows actual behavior
63
63
 
64
+ For a large module, divide work by reader question or capability family, not
65
+ by an exhaustive symbol list. Put useful directory and entrypoint hints in the
66
+ task brief. Investigate one bounded slice first and keep remaining scope in the
67
+ existing plan; do not wait for a module-wide catalog before writing. Reuse shared
68
+ findings in temporary files across related tasks, checking source evidence for
69
+ new claims. If a task proves too broad, amend unfinished tasks rather than
70
+ expanding every dependency recursively. A complete component manual still needs
71
+ coverage of its agreed components, spread across manageable tasks.
72
+
73
+ Use explicit file selections for optional deep analysis. Package export tracing
74
+ can still follow other files to establish public identity, so selected output
75
+ does not guarantee a cheap scan. Prefer direct reading when that traversal is
76
+ unnecessary; stop or narrow a helper that exceeds the useful time/output budget.
77
+
64
78
  Explain what the module is responsible for, when and how to enter it through
65
79
  stable interfaces, what it hands off, and the relevant state and failure
66
80
  boundaries. A directory summary or symbol list is not an explanation.
@@ -11,7 +11,7 @@ compatibility layers, gateways, and translators whose stable responsibility is
11
11
  to connect two boundaries. An ordinary internal helper that converts one object
12
12
  is not automatically an adapter module.
13
13
 
14
- Use the exact profile and Artifact policy variant supplied by the workset. For
14
+ Follow the current task.md, sources.md and submission schema. For
15
15
  an inbound operation surface, combine this template with the selected gateway
16
16
  or protocol evidence without creating a second operation registry.
17
17
 
@@ -11,7 +11,7 @@ surface as `api-service`. A module that only calls a remote API is a protocol
11
11
  consumer, not automatically an API service. Gateways that translate to another
12
12
  protocol normally also selects `adapter-integration`.
13
13
 
14
- Use the exact profile and Artifact policy variant supplied by the workset. If
14
+ Follow the current task.md, sources.md and submission schema. If
15
15
  the reader goal is primarily the transformation between inbound and outbound
16
16
  boundaries, use the selected adapter-integration profile and retain one
17
17
  canonical operation registry.
@@ -10,7 +10,7 @@ Use for `background-runtime`: queue or stream consumers, scheduled jobs,
10
10
  pipelines, functions, controllers, watchers, and long-running agents activated
11
11
  by a trigger instead of an interactive request.
12
12
 
13
- Use the exact profile and Artifact policy variant supplied by the workset.
13
+ Follow the current task.md, sources.md and submission schema.
14
14
 
15
15
  ## Evidence pass
16
16
 
@@ -11,7 +11,7 @@ executables, generators, and command-driven plugin hosts. A build script used
11
11
  only internally does not need a CLI knowledge unit unless it is a supported
12
12
  operator or contributor surface.
13
13
 
14
- Use the exact profile and Artifact policy variant supplied by the workset.
14
+ Follow the current task.md, sources.md and submission schema.
15
15
 
16
16
  ## Evidence pass
17
17
 
@@ -12,7 +12,7 @@ imports and component contracts. A web application that happens to contain
12
12
  shared components remains a `web-application` unless the component surface is
13
13
  published as an independent consumer boundary.
14
14
 
15
- Use the exact profile and Artifact policy variant supplied by the workset.
15
+ Follow the current task.md, sources.md and submission schema.
16
16
 
17
17
  ## Evidence pass
18
18
 
@@ -30,10 +30,10 @@ Treat stories and examples as usage evidence, not as authority for unsupported
30
30
  props or behavior. When generated declarations disagree with source, identify
31
31
  the authoritative source and record the gap.
32
32
 
33
- When the Authorized Workset View supplies a public declaration together with
33
+ When the task's authorized sources supply a public declaration together with
34
34
  structured props, events, defaults, variants, maintained examples, or source
35
- roles, the corresponding reader section must consume those facts or record an
36
- explicit supported omission/material-gap disposition. Do not replace available
35
+ roles, use the relevant facts in the reader section and explain essential
36
+ missing material. Do not replace available
37
37
  contract facts with a generic statement about the component directory. A component group
38
38
  without a reader-authorizing public declaration remains catalog-only and does
39
39
  not produce an empty component page. Library and system subjects may instead be
@@ -11,7 +11,7 @@ IDL, OpenAPI document, schema registry, message contract, or equivalent
11
11
  machine-readable interface definition. It defines contracts consumed by other
12
12
  modules but does not need to execute or dispatch them itself.
13
13
 
14
- Use the exact profile and Artifact policy variant supplied by the workset.
14
+ Follow the current task.md, sources.md and submission schema.
15
15
  Generated projections must point back to this authority and remain supporting
16
16
  evidence rather than a second contract authority.
17
17
 
@@ -52,16 +52,14 @@ Examples include application-to-client-to-endpoint, endpoint-to-service-to-
52
52
  repository, producer-to-event-to-consumer, command-to-remote-operation, and
53
53
  plugin-host-to-provider.
54
54
 
55
- ## Partition and ownership rule
55
+ ## Article scope and source reuse
56
56
 
57
- A flow normally cites sources already owned by module units. Give the flow one
58
- stable article identity and keep module inventory ownership unchanged; its author
59
- workset may reference the exact cross-source evidence views but must not claim
60
- the same inventory members as a second primary owner.
57
+ A flow may reuse sources cited by module articles. Give the flow one stable
58
+ article identity and use the current task's authorized sources. No primary
59
+ owner or inventory membership is required; avoid duplicating existing prose.
61
60
 
62
- The aggregate candidate may cite evidence from every participating source. It
63
- must cover all Route-reported structural probes selected by the flow profile;
64
- one page may cover several probes when it carries each exact evidence locator.
61
+ The article may cite every authorized participating source. Cover the reader
62
+ question and relevant handoffs defined in the task brief.
65
63
  Explain operations and handoffs in reader prose, links or diagrams, citing the
66
64
  actual source regions for each fragment (at most three locations per fragment).
67
65
  Do not emit graph edges, classify nodes or create a relationship ledger.
@@ -11,7 +11,7 @@ reusable service contract and its first-level orchestration. Do not classify a
11
11
  directory as a service merely because it contains classes or functions named
12
12
  `Service`.
13
13
 
14
- Use the exact profile and Artifact policy variant supplied by the workset.
14
+ Follow the current task.md, sources.md and submission schema.
15
15
 
16
16
  ## Evidence pass
17
17
 
@@ -11,7 +11,7 @@ registration, ownership, dependency, build, or release topology of multiple
11
11
  child modules. Do not treat the physical repository as one application merely
12
12
  because it has one Git remote.
13
13
 
14
- Use the exact profile and Artifact policy variant supplied by the workset.
14
+ Follow the current task.md, sources.md and submission schema.
15
15
 
16
16
  ## Evidence pass
17
17
 
@@ -11,8 +11,7 @@ SDKs, public framework extensions, or shared runtimes consumed through a
11
11
  deliberately supported interface. A package being imported elsewhere is not
12
12
  enough; confirm its supported entry and consumer contract.
13
13
 
14
- Use the exact sdk-library or component-library profile and Artifact policy
15
- variant supplied by the workset.
14
+ Follow the current task.md, sources.md and submission schema.
16
15
 
17
16
  ## Evidence pass
18
17
 
@@ -15,7 +15,7 @@ only browser code. It does
15
15
  not automatically cover every package containing UI components; a reusable
16
16
  component package is usually `sdk-library`.
17
17
 
18
- Use the exact profile and Artifact policy variant supplied by the workset.
18
+ Follow the current task.md, sources.md and submission schema.
19
19
 
20
20
  ## Evidence pass
21
21