@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.
- package/cli.js +1154 -754
- package/indexers/bundles/context-code-indexer/references/indexer.md +14 -0
- package/indexers/bundles/context-code-indexer/templates/adapter-integration.md +1 -1
- package/indexers/bundles/context-code-indexer/templates/api-service.md +1 -1
- package/indexers/bundles/context-code-indexer/templates/background-runtime.md +1 -1
- package/indexers/bundles/context-code-indexer/templates/cli-tool.md +1 -1
- package/indexers/bundles/context-code-indexer/templates/component-library.md +4 -4
- package/indexers/bundles/context-code-indexer/templates/contract-source.md +1 -1
- package/indexers/bundles/context-code-indexer/templates/data-sync-reconciliation.md +6 -8
- package/indexers/bundles/context-code-indexer/templates/domain-service.md +1 -1
- package/indexers/bundles/context-code-indexer/templates/monorepo-container.md +1 -1
- package/indexers/bundles/context-code-indexer/templates/sdk-library.md +1 -2
- package/indexers/bundles/context-code-indexer/templates/web-application.md +1 -1
- package/indexers/contracts/profile-contract.json +245 -245
- package/indexers/release-manifest.json +14 -14
- package/package.json +12 -12
- package/parserEntryWorker.js +17 -8
- package/plugins/VERSION +1 -1
- package/plugins/claude/.claude-plugin/plugin.json +1 -1
- package/plugins/claude/commands/context.md +37 -73
- package/plugins/codex/.codex-plugin/plugin.json +2 -2
- package/plugins/codex/skills/context/SKILL.md +37 -73
- package/plugins/cursor/.cursor-plugin/plugin.json +1 -1
- package/plugins/cursor/commands/c4a-context.md +37 -73
- package/plugins/skills/context/SKILL.md +37 -73
- package/plugins/skills/context-code-indexer/references/indexer.md +14 -0
- package/plugins/skills/context-code-indexer/templates/adapter-integration.md +1 -1
- package/plugins/skills/context-code-indexer/templates/api-service.md +1 -1
- package/plugins/skills/context-code-indexer/templates/background-runtime.md +1 -1
- package/plugins/skills/context-code-indexer/templates/cli-tool.md +1 -1
- package/plugins/skills/context-code-indexer/templates/component-library.md +4 -4
- package/plugins/skills/context-code-indexer/templates/contract-source.md +1 -1
- package/plugins/skills/context-code-indexer/templates/data-sync-reconciliation.md +6 -8
- package/plugins/skills/context-code-indexer/templates/domain-service.md +1 -1
- package/plugins/skills/context-code-indexer/templates/monorepo-container.md +1 -1
- package/plugins/skills/context-code-indexer/templates/sdk-library.md +1 -2
- package/plugins/skills/context-code-indexer/templates/web-application.md +1 -1
- package/providers/context/manifest.json +20 -20
- package/providers/context/provider.yaml +1 -1
- package/providers/context/resources/manuals/guides/indexer-provider-and-customization.md +0 -2
- package/providers/context/resources/manuals/guides/knowledge-updates.md +28 -2
- package/providers/context/resources/manuals/guides/workspace-prepare.md +17 -0
- package/providers/context/resources/manuals/reference/project-api.md +37 -17
- package/providers/context/resources/procedures/close-and-build.md +21 -0
- package/providers/context/resources/procedures/knowledge-updates.md +28 -2
- package/providers/context/resources/procedures/production-stage-files.md +14 -0
- package/providers/context/resources/procedures/source-capture-detailed.md +16 -2
- package/providers/context/resources/procedures/work-start-report.md +10 -4
- 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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
36
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
55
|
+
## Article scope and source reuse
|
|
56
56
|
|
|
57
|
-
A flow
|
|
58
|
-
|
|
59
|
-
|
|
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
|
|
63
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
18
|
+
Follow the current task.md, sources.md and submission schema.
|
|
19
19
|
|
|
20
20
|
## Evidence pass
|
|
21
21
|
|